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Radio and Television Interference 



A shielded cable is a cable that uses a 
metallic wrap around the wires to reduce 
the potential effects of radio frequency 
interference. 



The equipment described in this manual generates and uses 
radio-frequency energy. If it is not installed and used properly— that is, in 
strict accordance with our instructions— it may cause interference with 
radio and television reception. 

This equipment has been tested and complies with the limits for a Class B 
computing device in accordance with the specifications in Subpart J, 
Part 15, of FCC rules. These rules are designed to provide reasonable 
protection against such interference in a residential installation. However, 
there is no guarantee that the interference will not occur in a particular 
installation, especially if a "rabbit ear' 1 television antenna is used. (A "rabbit 
ear" antenna is the telescoping-rod type usually contained on television 
receivers.) 

You can determine whether your computer is causing interference by 
turning it off. If the interference stops, it was probably caused by the 
computer or its peripherals. To further isolate the problem, disconnect the 
peripheral devices and their input/output cables one at a time. If the 
interference stops, it was caused by either the peripheral device or the I/O 
cable. These devices usually require shielded I/O cables. For Apple 
peripherals, you can obtain the proper shielded cable from your dealer. 
For non-Apple peripheral devices, contact the manufacturer or dealer for 
assistance. 

If your computer does cause interference to radio or television reception, 
you can try to correct the interference by using one or more of the following 
measures: 

d Turn the television or radio antenna until the interference stops. 
□ Move the computer to one side or the other of the television or radio. 
d Move the computer farther away from the television or radio. 
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d Plug the computer into an outlet that is on a different circuit than the 
television or radio. (That is, make certain the computer and the radio or 
television set, are on circuits controlled by different circuit breakers or 
fuses.) 

a Consider installing a rooftop television antenna with coaxial cable lead-in 
between the antenna and television. 

If necessary, you should consult your Apple-authorized dealer or an 
experienced radio/television technician for additional suggestions. 
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Preface 



About This Manual 



This is the reference manual for the Apple lie personal computer. It 
contains detailed descriptions of all of the hardware and firmware that 
make up the Apple He and provides the technical information that 
peripheral-card designers and programmers need. 

This manual contains a lot of information about the way the Apple lie 
works, but it doesn't tell you how to use the Apple He. For this, you should 
read the other Apple He manuals, especially the following: 

d Apple He Owner's Manual 
u The Applesoft Tutorial 



Contents of This Manual 

The material in this manual is presented roughly in order of increasing 
intimacy with the hardware; the farther you go in the manual, the more 
technical the material becomes. The main subject areas are 

□ introduction: Preface and Chapter 1 

□ use of built-in features: Chapters 2 and 3 
a how the memory is organized: Chapter 4 

d information for programmers: Chapters 5 and 6 

□ hardware implementation: Chapter 7 

d additional information: appendixes, glossary, and bibliography. 

Chapter 1 identifies the main parts of the Apple He and tells where in the 
manual each part is described. 

The next two chapters describe the built-in input and output features of the 
Apple He. This part of the manual includes information you need for 
low-level programming on the Apple He. Chapter 2 describes the built-in I/O 
features and Chapter 3 tells you how to use the firmware that supports 
them. 
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Chapter 4 describes the way the Apple He's memory space is organized, 
including the allocation of programmable memory for the video display 
buffers. 

Chapter 5 is a user manual for the Monitor that is included in the built-in 
firmware. The Monitor is a system program that you can use for program 
debugging at the machine level. 

Chapter 6 describes the programmable features of the peripheral-card 
connectors and gives guidelines for their use. It also describes interrupt 
programming on the Apple He. 

Chapter 7 is a description of the hardware that implements the features 
described in the earlier chapters. This information is included primarily for 
programmers and peripheral-card designers, but it will also help you if you 
just want to understand more about the way the Apple lie works*. 

Additional reference information appears in the appendixes. Appendix A is 
the manufacturer's description of the Apple He's microprocessor. 

Appendix B is a directory of the built-in I/O subroutines, including their 
functions and starting addresses. 

Appendix C describes differences among Apple II family members. 

Appendix D describes some of the operating systems and languages 
supported by Apple Computer for the Apple He. 

Appendix E contains conversion tables of interest to programmers. 

Appendix F contains additional copies of some of the tables that appear in 
the body of the manual. The ones you will need to refer to often are 
duplicated here for easy reference. 

Appendix G contains information about using Apple He 80-coIurrm test 
cards with the Applalle and high level languages. 

Appendix H discusses programming on the Apple lie with the Apple Super 
Serial Card. 

Appendix I contains the source listing of the Monitor firmware. You can 
refer to it to find out more about the operation of the Monitor subroutines 
listed in Appendix B. 

Following Appendix I is a glossary defining many of the technical terms 
used in this manual. Some terms that describe the use of the Apple He are 
defined in the glossaries of the other manuals listed earlier. 

Following the glossary, there is a selected bibliography of sources of 
additional information. 
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Preface: About This Manual 



The Enhanced Apple He 



Changes have been made in the Apple He since the original version was 
introduced. The new version is called the enhanced Apple lie and is 
described in this manual. Where there are differences in the original 
Apple He compared with the enhanced Apple He, they will be called out in 
the manual. Otherwise, the two machines operate identically. 

You can tell whether you have an original or enhanced Apple he when you 
start up the system. An original Apple lie will display Apple n at the top 
of the monitor screen, while an enhanced Apple He will display 

Apple //e. 

The changes embodied in the enhanced Apple He are described in the 
following sections of this preface. 



Opcode is short for operation code and is 
used to describe the basic instructions 
performed by the central processing unit of 
a computer. 



Physical Changes 

The enhanced Apple lie includes the following changes from the original 
Apple He: 

□ The 65C02 microprocessor, which is a new version of the 6502 
microprocessor found in the original Apple He. The 65C02 uses less 
power, has 27 new opcodes, and runs at the same speed as the 6502. 
(See Chapter 7 and Appendix A.) 

□ A new video ROM containing the same MouseText characters found in 
the Apple lie. (See Chapter 2.) 

□ New Monitor ROMs (the CD and EF ROMs) containing the enhanced 
Apple He firmware. (See Chapter 5.) 

□ The identification byte at $FBC0 has been changed. In the original 
Apple He it was $EA (decimal 234), in the enhanced Apple He it is $E0 
(decimal 224). 



Startup Drives 

You can use startup (boot) devices other than a Disk II to start up ProDOS 
on the enhanced Apple He. 

Apple II Pascal versions 1.3 and later may start up from slots 4, 5, or 6 on a 
Disk II, ProFile, or other Apple II disk drive. Apple II Pascal versions 1.0 
through 1.2 must start up from a Disk II in slot 6. 

DOS 3.3 may be started from a Disk II in any slot. 



The Enhanced Apple lie 



When you turn on your Apple lie, it searches for a disk drive controller to 
start up from, beginning with slot 7 and working down toward slot 1. As 
soon as a disk controller card is found, the Apple lie will try to load and 
execute the operating system found on the disk. If the drive is not a Disk II, 
then the operating system of the startup volume must be either ProDOS or 
Apple II Pascal (version 1.3 or later). If it is a Disk II, then the startup 
volume may be any Apple II operating system. 



Video F irmware 

The enhanced Apple He has improved 80-column firmware: 

□ The enhanced Apple He now supports lowercase input. 

□ I esc 1 1 control H Tj passes most control characters to the screen. 

□ | esc || control H ~d~1 traps most control characters before they get to the 
screen, 

□ I esc I [r] was removed because uppercase characters are no longer 
required by Applesoft, 

Video Enhancements 

Both 80-column Pascal and 80-column mode Applesoft output are faster 
than before and scrolling is smoother. 40-column Pascal performance is 
unchanged. 

In the original Apple He, characters echoed to COUT1 during 80-column 
operation were printed in every other column; the enhanced Apple He 
firmware now prints the characters in each column. 

Applesoft 80-Column Support 

The following Applesoft routines now work in 80-column mode: 

□ HTAB 

□ TAB 

□ SPC 

□ Comma tabbing in PRINT statements 
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Applesoft Lowercase Support 

Applesoft now lets you do all your programming in lowercase, When you list 
your programs, all Applesoft keywords and variable names automatically 
are in uppercase characters; literal strings and the contents of DATA and 
REM statements are unchanged. 



To find out more, see the Pascal Profile 
Manager Manual. 



Apple II Pascal 

Apple II Pascal'(version 1.2 and later) can now use a ProFile hard disk 
through the Pascal ProFile Manager. 

The Pascal 1.1 firmware no longer supports the control character that 
switches from 80-column to 40-column operation. This control character is 
no longer supported because it can put Pascal in a condition where the 
exact memory configuration is not known. 



System Monitor Enhancements 



Enhancements to the Apple He's built-in Monitor (described in Chapter 5 in 
this manual) include the following; 

a lowercase input 

a ASCII input mode 

□ Monitor Search command 

□ the Mini-Assembler 



Interrupt Handling 

Interrupt handler support in the enhanced Apple He firmware now handles 
any Apple lie memory configuration. 



r 
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Symbols Used in This Manual 



AWarning 
Important! 



Definitions, cross-references, and other 
short, items appear in marginal glosses like 
this. 



Special text in this manual is set off in several different ways, as shown in 
these examples. 

I Important warnings appear in red like this. These flag potential danger to 
' the Apple He, its software, or you. 

The information here is important, but non-threatening. The ways in 
which the original Apple lie differs from the enhanced Apple He are 
called out this way with the tag Original lie in the margin. 

By the Way: Information that is useful but is incidental to the text is set 
off like this. You may want to skip over such information and return to it 

later. 

Terms that are defined in a marginal gloss or in the glossary appear in 
boldface. 
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Chapter 1 



Introduction 




This first chapter introduces you to the Apple He itself. It shows you what 
the inside looks like, identifies the major components that make up the 
machine, and tells you where to find information about each one. 



Removing the Cover 

Remove the cover of the Apple He by pulling up on the back edge until the 
fasteners on either side pop loose, then move the cover an inch or so toward 
the rear of the machine to free the front of the cover, as shown in Figure 1-1. 
What you will see is shown in Figure 1-2. 



Figure 1-1. Removing the Cover 



Figure 1-2. The Apple He With the Cover Off 
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▲Warning 



There is a red LED (light-emitting diode} inside the Apple He, in the left 
rear corner of the circuit board. If the LED is on, it means that the power 
is on and you must turn it off before you insert or remove anything, To 
avoid damaging the Apple He, don't even think of changing anything 
inside it without first turning off the power. 



ASCII stands tor American Code for 
Information Interchange. 



The Keyboard 



The keyboard is the Apple lie's primary input device. As shown in 
Figure 1-3, it has a normal typewriter layout, uppercase and lowercase, with 
all of the special characters in the ASCII character set. The keyboard is 
fully integrated into the machine; its operation is described in the first part 
of Chapter 2. Firmware subroutines for reading the keyboard are described 
in Chapter 3. 



Figure 1-3. The Apple He Keyboard 
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The Speaker 



The Apple He has a small loudspeaker in the bottom of the case. The 
speaker enables Apple He programs to produce a variety of sounds that 
make the programs more useful and interesting. The way programs control 
the speaker is described in Chapter 2. 



The Speaker 



The Power Supply 



The power supply is inside the flat metal box along the left side of the 
interior of the Apple He. It provides power for the main board and for any 
peripheral cards installed in the Apple He. 

The power supply produces four different voltages: +5 V, -5V, +12V, and 
-12V. It is a high-efficiency switching supply; it includes special circuits that 
protect it and the rest of the Apple He against short circuits and other 
mishaps. Complete specifications of the Apple He power supply appear in 
Chapter 7. 



▲Warning 



The power switch and the socket for the power cord are mounted directly 
on the back of the power supply's metal case. This mounting ensures that 
all the circuits that carry dangerous voltages are inside the power supply. 
Do not defeat this design feature by attempting to open the power supply. 



The Circuit Board 



All of the electronic parts of the Apple He are attached to the circuit board, 
which is mounted flat in the bottom of the case. 

Figure 1-4 shows the main integrated circuits (ICs) in the Apple He. They 
are the central processing unit (CPU), the keyboard encoder, the keyboard 
read-only memory (ROM), the two interpreter ROMs, the video ROM, and 
the custom integrated circuits: the Input/Output Unit (IOU), the Memory 
Management Unit (MMU), and the Programmed Array Logic (PAL) device. 
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Figure 14. The Circuit Board 
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The Circuit Board 



Original lie 



The CPU is a 65C02 microprocessor. The 65C02 is an enhanced version of 
the 6502, which is an eight-bit microprocessor with a sixteen-bit address 
bus. It uses instruction pipelining for faster processing than comparable 
microprocessors. In the Apple lie, the 65C02 runs at 1.02 MHz and performs 
up to 500,000 eight-bit operations per second. The specifications of the 
65C02 and its instruction set are given in Appendix A. 

The original version of the Apple He uses the 6502 microprocessor. You can 
tell which version of Apple lie that you have by starting up your machine. 
An original Apple lie displays Apple u at the top of the screen during 
startup, while an enhanced Apple He displays Apple / / e . This manual 
will call out specific areas where the two versions of the Apple lie are 
different. 

The 6502 is very similar to the 65C02, but lacks 10 instructions and 2 
addressing modes found on the 65C02. The 6502 is an NMOS device and 
so uses more power than the CMOS 65C02. Except for the differences 
listed above, and some minor differences in the number of clock cycles 
used by some instructions, the two microprocessors are identical. 

The keyboard is decoded by an AY-3600-type integrated circuit and a 
read-only memory (ROM). These devices are described in Chapter 7. 

The interpreter ROMs are integrated circuits that contain the Applesoft 
BASIC interpreter. The ROMs are described in Chapter 7. The Applesoft 
language is described in the Applesoft Tutorial and the Applesoft BASIC 
Programmer's Reference Manual. 

Two of the large ICs are custom-made for the Apple He: the MMU and the 
IOU, The MMU IC contains most of the logic that controls memory 
addressing in the Apple He. The organization of the memory is described in 
Chapter 4; the circuitry in the MMU itself is described in Chapter 7. 

The IOU IC contains most of the logic that controls the built-in input/output 
features of the Apple He, These features are described in Chapter 2 and 
Chapter 3; the IOU circuits are described in Chapter 7. 



Connectors on the Circuit Board 

The seven slots lined up along the back of the Apple He circuit board are the 
expansion slots, sometimes called peripheral slots. (See Figure 1-5.) These 
slots make it possible to attach additional hardware to the Apple He. 
Chapter 6 tells you how your programs deal with the devices that plug into 
these slots; Chapter 7 describes the circuitry for the slots themselves. 
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Figure 1-5. The Expansion Slots 




The large slot next to the left-hand side of the circuit board is the auxiliary 
slot (Figure 1-6). If your Apple He has an Apple He 80-column text card, it 
will be installed in this slot. The 80-column display option is fully integrated 
into the Apple He; it is described along with the other display features in 
Chapter 2. The hardware and firmware interfaces to this card are described 
in Chapter 7. 

Figure 1-6. The Auxiliary Slot 




There are also smaller connectors for game I/O and for an internal RF 
(radio frequency) modulator. These connectors are described in Chapter 7. 
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Connectors on the Circuit Board 



Connectors on the Back Panel 



The back of the Apple He has two miniature phone jacks for connecting a 
cassette recorder, an RCA-type jack for a video monitor, and a 9-pin D-type 
miniature connector for the hand controls, as shown in Figure 1-7. In 
addition to these, there are spaces for additional connectors used with the 
peripheral cards installed in the Apple He. The installation manuals for the 
peripheral cards contain instructions for installing the peripheral 
connectors. 



Figure 1-7. The Back Panel Connectors 
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Chapter 2 



Built-in I/O Devices 




■ 




For descriptions of the built-in I/O 
hardware refer to Chapter 7. 



Built-in I/O firmware routines are 
described in Chapter 3. 



This chapter describes the input and output (I/O) devices built into the 
Apple He in terms of their functions and the way they are used by 
programs. The built-in I/O devices are 

□ the keyboard 

□ the video-display generator 

□ the speaker 

□ the cassette input and output 

□ the game input and output. 

At the lowest level, programs use the built-in I/O devices by reading and 
writing to dedicated memory locations. This chapter lists these locations for 
each I/O device. It also gives the locations of the internal soft-switches that 
select the different display modes of the Apple He. 

Built-in I/O Routines: This method of input and output— loading and 
storing directly to specific locations in memory— is not the only method 
you can use. For many of your programs, it may be more convenient to 
call the built-in I/O routines stored in the Apple He's firmware, 



The Keyboard 



The primary input device of the Apple He is its built-in keyboard. The 
keyboard has 63 keys and is similar to a typewriter keyboard. The Apple He 
keyboard has automatic repeat on all keys: hold the key down to repeat. It 
also has N-key rollover, which means that you can hold down any number 
of keys while typing another. Of course, if you hold the keys down much 
longer than the length of time you would hold them down during normal 
typing, the automatic-repeat function will start repeating the last key you 
pressed. 

The keyboard arrangement shown in Figure 2-1 is the standard one used in 
the United States. The specifications for the keyboard are given in 
Table 2-1. Apple He's manufactured for sale outside the United States have 
a slightly different standard keyboard arrangement and include provisions 
for switching between two different arrangements. 
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Figure 2-1 . The Keyboard 
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Table 2-1. Apple He Keyboard Specifications 



Number of keys: 
Character encoding: 
Numbe* of codes: 
Features; 

Special function keys: 
Cursor movement keys: 
Modifier keys: 
Electrical Interface: 



ASCII 

128 

Automatic repeat, two-key rollover 

fRESEfl , nsi, rn 



Q Q LB LB I RETURN 1 , 1 DELETE I , [W] 
| CONTROL | , | SHIFT[ , | CAPS LOCK] , | ESC ] 

AY-5-3600 keyboard encoder 



In addition to the keys normally used for typing characters, there are four 
cursor-control keys with arrows: left, right, down, and up. The 
cursor-control keys can be read the same as other keys; their codes are $08, 
$15, $0A, and SOB. (See Table 2-3.) 

Three special keys, | control | , I shift | , and icaps lock! change the 
codes generated by the other keys. The | control I key is similar to the 
ASCII CTRL key. 

Three other keys have special functions: the | reset | key, and two keys 
marked with apples, one outlined, or open (Tol), and one solid, or closed 
QT|), Pressing the | reset 1 key with the | control | key depressed resets 
the Apple He, as described in Chapter 4. The Apple keys are connected to 
the one-bit game inputs, described later in this chapter. 



The Keyboard 



:: 



See Chapter 7 for a complete description of 
the elecrtica] interface to the keyboard 



The electrical interface between the Apple He and the keyboard is a ribbon 
cable with a 26-pin connector. This cable carries the keyboard signals to the 
encoding circuitry on the main board. 



Reading the Keyboard 

The keyboard encoder and ROM generate all 128 ASCII codes, so all of the 
special character codes in the ASCII character set are available from the 
keyboard. Machine-language programs obtain character codes from the 
keyboard by reading a byte from the keyboard-data location shown in 
Table 2-2. 






Table 2-2. Keyboard Memory Locations 



'.oeation 
Hex J>ecimal 



SC010 



49152 
49168 



-ltnjMJ4 

-16368 



Description 



Keyboard data and strobe 
Aw-key-down flag and clear-strobe switch 



Hexadecimal refers to the base-16 number 
system, which uses the digits through 9 
and the six letters A through F to represent, 
values from Oto 15, 



Your programs can get the code for the last Av?y pressed by reading the 
keyboard-data location. Table 2-2 gives this location in three different 
forms: the hexadecimal value used in assembly JWiguage, indicated by a 
preceding dollar sign ($); the decimal value used in AppOesoft BASIC and 
the complementary decimal value used in Apple Integer b^gic. (Integer 
BASIC requires that values greater than 32767 be written as i^e number 
obtained by subtracting 65536 from the value. These are the decimal 
numbers shown as negative in tables in this manual; refer to the^npte// 
BASIC Programming Manual) The low-order seven bits of the byte at 
the keyboard location contain the character code; the high-order bit bf t^ 
byte is the strobe bit, described later in this section. 

Your program can find out whether any key is down, except the | reset j , 
I control l , I shift | , |caps lock 1 , [a], and (7] keys by reading from 
location 49168 (hexadecimal $C010 or complementary decimal -16368). The 
high-order bit (bit 7) of the byte you read at this location is called 
any-key-down; it is 1 if a key is down, and if no key is down. The value of 
this bit is 128; if a BASIC program gets this information with a PEEK, the 
value is 128 or greater if any key is down, and less than 128 if no key is 
down. 
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■ 



Important! 



The reset routine is described in Chapter 4. 



The [g] and [¥] keys are connected to switches and 1 of the game I/O 
connector inputs. If [o] is pressed, switch is "pressed," and if mis 
pressed, switch 1 is "pressed." 

The strobe bit is the high-order bit of the keyboard-data byte. After any key 
has been pressed, the strobe bit is high. It remains high until you reset it by 
reading or writing at the clear-strobe location. This location is a combination 
flag and switch; the flag tells whether any key is down, and the switch 
clears the strobe bit. The switch function of this memory location is called a 
soft switch because it is controlled by software. In this case, it doesn't 
matter whether the program reads or writes, and it doesn't matter what 
data the program writes: the only action that occurs is the resetting of the 
keyboard strobe, Similar soft switches, described later, are used for 
controlling other functions in the Apple He. 

Any time you read the any-key-down flag, you also clear the keyboard 
strobe. If your program needs to read both the flag and the strobe, it must 
read the strobe bit first. 

After the keyboard strobe has been cleared, it remains low until another key 
is pressed. Even after you have cleared the strobe, you can still read the 
character code at the keyboard location. The data byte has a different 
value, because the high-order bit is no longer set, but the ASCII code in the 
seven low-order bits is the same until another key is pressed. Table 2-3 
shows the ASCII codes for most of the keys on the keyboard of the 
Apple He. 

There are several special-function keys that do not generate ASCII codes. 
For example, you cannot read the l control l I shift i and icaps lock] 
keys directly, but pressing one of these keys alters the character codes 
produced by the other keys. 

Another key that doesn't generate a code is I reset l located at the 
upper-right corner of the keyboard; it is connected directly to the Apple lie's 
circuits. Pressing | reset i with [ control | depressed normally causes the 
system to stop whatever program it's running and restart itself. This 
restarting process is called the reset routine. 

Two more special keys are the Apple keys, [a] and (T)> located on either 
side of the | space I bar. These keys are connected to the one-bit game 
inputs, which are described later in this chapter in the section "Switch 
Inputs." Pressing them in combination with the 1 control | and | reset | 
keys causes the built-in firmware to perform special reset and self-test 
cycles, described with the reset routine in Chapter 4. 



The Keyboard 
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Table 2-3. Keys and ASCII Codes 



Note: Codes are shown here 
to Table E-2. 


in hexadecimal; 


to find the decimal equivalents, refer 




Normal 


Control 




Shift 




Both 


Key 


Code 


Char 


Code 


Char 


Code 


Char 


Code 


Char 


| DELETE ] 


7F 


DEL 


7F 


DEL 


7F 


DEL 


7F 


DEL 


Q 


08 


BS 


08 


BS 


OK 


BS 


m 


BS 


LjabJ 


09 


HI 


09 


HT 


09 


HT 


09 


HT 


a 


0A 


Lr 


0A 


LF 


0A 


LF 


0A 


LF 


s 


OB 


VT 


0B 


VT 


OB 


VT 


OB 


VT 


I RETURN 


0D 


CR 


0D 


CR 


0D 


CR 


OD 


CR 


Q 


15 


NAK 


15 


NAK 


15 


NAK 


15 


NAK 


[Use] 


IB 

20 


ESC 
SP 


IB 
20 


ESC 
SP 


IB 

20 


ESC 
SP 


IB 
20 


ESC 


I SPACE | 


SP 


i n 


27 


l 


27 


1 


22 


fP 


22 


" 


,< 


2C 


J 


2C 


) 


3C 


< 


30 


< 


- — 


2D 


- 


IF 


US 


5F 





IF 


US 


> 


2E 




2E 




3E 


> 


3E 


> 


/? 


2F 


/ 


2F 


/ 


3F 


9 


3F 


? 


00 


*"' 





30 





29 


) 


29 


) 


1! 


31 


1 


31 


1 


21 


1 


21 


1 


2@ 


32 


2 


00 


NUL 


40 


@ 


uo 


NUL 


3# 


33 


3 


33 


3 


23 


§ 


23 


# 


4$ 


34 


4 


34 


4 


24 


$ 


34 


S 


5% 


35 


5 


35 


5 


25 


% 


25 


% 


6' 


m 


6 


IE 


RS 


5E 




IF 


RS 


7& 


37 


7 


37 


7 


26 


& 


29 


& 


8* 


38 


3 


38 


8 


2A 


* 


Ik 


* 


9( 

> ■ 


39 

33 


9 


39 
3B 


9 

1 


28 
3A 


c 


28 
3A 


( 


= + 


3D 


= 


3D 


= 


2B 


+ 


2B 


+ 


H 


5B 


[ 


IB 


ESC 


7B 


1 


IB 


ESC 


\l 


50 


\ 


1C 


FS 


7C 


1 


1C 


FS 


]}. 


5D 


1 


ID 


GS 


7D 


} 


ID 


GS 




60 




60 




7E 




7E 


" 
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Table 2-3— Continued. Keys and ASCII Codes 



Note: Codes are si 
to Table E-2. 


,own here 


to hexadecimal; to find the decimal equivalents, refer 


Key 


Normal 
Code Char 


Control 
Code Char 


Code 


Shift 
Char 


Code 


Both 
Char 


A 


61 


a 


31 


SOH 


41 


A 


01 


SOH 


B 


62 


b 


02 


STX 


42 


B 


02 


STX 


C 


03 


c 


08 


ETX 


43 


G 


oa 


ETX 


D 


64 


c 


34 


EOT 


44 


D 


04 


EOT 


E 


65 


e 


05 


ENQ 


45 


E 


05 


ENQ 


F 


66 


f 


06 


ACK 


46 


F 


06 


ACK 


G 


67 


a 


07 


BEL 


47 


G 


07 


BEL 


H 


68 


h 


08 


BS 


48 


H 


08 


BS 


I 


69 


i 


09 


HT 


49 


[ 


09 


HT 


J 


6A 


J 


0A 


LF 


4A 


J 


0A 


LF 


K 


BB 


k 


0B 


VT 


4B 


K 


0B 


VT 


L 


60 


1 


oc 


FF 


4C 


L 


OC 


FF 


M 


6D 


m 


0D 


CR 


4D 


M 


01) 


CR 


N 


6E 


n 


0E 


SO 


412 


N 


0E 


SO 





6F 





OF 


SI 


4" 


O 


OF 


SI 


F 


70 


P 


10 


DLE 


50 


P 


10 


DLE 


Q 


71 


Q 


11 


DC1 


51 


Q 


11 


DC1 


R 


72 


r 


12 


DC2 


52 


R. 


12 


DC2 


S 


73 


s 


13 


DC3 


53 


S 


13 


DC3 


T 


74 


t 


14 


DC4 


54 


T 


14 


DC4 


U 


75 


u 


15 


NAK 


55 


U 


15 


NAK 


V 


7H 


V 


16 


SYN 


56 


V 


16 


SYN 


w 


77 


w 


17 


ETB 


57 


w 


L7 


ETB 


X 


78 


s 


18 


CAN 


58 


X 


18 


CAN 


Y 


79 


y 


19 


EM 


59 


Y 


19 


EM 


z 


7A 


z 


1A 


SUB 


5A 


Z 


1A 


SUB 



I 

i 



The Keyboard 



15 



The Video Display Generator 



Important! 



Original He 



For a full description of the video signal 
and the connections to the Molex-type pins, 
refer to the section "Video Output Signals " 
in Chapter 7. 



The primary output device of the Apple lie is the video display. You can use 
any ordinary video monitor, either color or black-and-white, to display video 
information from the Apple lie. An ordinary monitor is one that accepts 
composite video compatible with the standard set by the NTSC (National 
Television Standards Committee). If you use Apple He color graphics with a 
black-and-white monitor, the display will appear as black and white (or 
green or amber or...) and various patterns of these two shades mixed 
together. 

If you are using only 40-column text and graphics modes, you can use a 
television set for your video display. If the TV set has an input connector for 
composite video, you can connect it directly to your Apple He; if it does not, 
you'll need to attach a radio frequency (RF) video modulator between the 
Apple lie and the television set. 

With the 80-column text card installed, the Apple He can produce an 
80-colurrm text display. However, if you use an ordinary color or 
black-and-white television set, 80-column text will be too blurry to read. 
For a clear 80-column display, you must use a high-resolution video 
monitor with a bandwidth of 14 MHz or greater. 

The specifications for the video display are summarized in Table 2-4. 

Note that MouseText characters are not included in the original version 
of the Apple He. 

The video signal produced by the Apple He is NTSC-compatible composite 
color video. It is available at three places: the RCA-type phono jack on the 
back of the Apple He, the single Molex-type pin on the main circuit board 
near the back on the right side, and one of the group of four Molex-type pins 
in the same area on the main board. Use the RCA-type phono jack to 
connect a video monitor or an external video modulator; use the Molex pins 
to connect the type of video modulator that fits inside the Apple He case. 
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Table 24. Video Display Specifications 



Display modes: 



Text capacity: 
Character set: 
Display formats; 
Low-resolution graphics: 

High-resolution graphics: 



Double-high-resolution 
graphics: 



40-column text; map: Figure 2-5 
80-column text; map: Figure 2-6 

Low-resolution color graphics; map: Figure 2-7 

High-resolution color graphics; map: Figure 2-8 

Double-high-res. color graphics; map: Figure 2-9 

24 lines by 80 columns (character positions) 

96 ASCII characters (uppercase and lowercase) 

Normal, inverse, flashing, MouseText (Table 2-5) 

16 colors (Table 2-6) 40 horizontal by 48 vertical; 
map: Figure 2-7 

6 colors (Table 2-7) 140 horizontal by 192 vertical 

(restricted) 

Black-and-white: 280 horizontal by 192 vertical; 
map: Figure 2-8 

16 colors (Table 2-8) 140 horizontal by 192 vertical 
(no restrictions) 

Black-and-white: 560 horizontal by 192 vertical; 
map: Figure 2-9 



The Apple lie can produce seven different kinds of video display; 

d text, 24 lines of 40 characters 

a text, 24 lines of 80 characters (with optional text card) 

d low-resolution graphics, 40 by 48, in 16 colors 

□ high-resolution graphics, 140 by 192, in 6 colors 

d high-resolution graphics, 280 by 192, in black and white 
d double high-resolution graphics, 140 by 192, in 16 colors (with optional 
64K text card) 

□ double high-resolution graphics, 560 by 192, in black and white (with 
optional 64K text card) 

The two text modes can display all 96 ASCII characters: the uppercase and 
lowercase letters, numbers, and symbols, The enchanced Apple He can also 
display MouseText characters. 
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Any of the graphics displays can have 4 lines of text at the bottom of the 
screen. The text may be either 40-column or 80-column, except that 
double-high-resolution graphics may only have 80-column text at the 
bottom of the screen. Graphics displays with text at the bottom are called 
mixed-mode displays. 

The low-resolution graphics display is an array of colored blocks, 40 wide by 
48 high, in any of 16 colors. In mixed mode, the 4 lines of text replace the 
bottom 8 rows of blocks, leaving 40 rows of 40 blocks each. 

The high-resolution graphics display is an array of dots, 280 wide by 192 
high. There are 6 colors available in high-resolution displays, but a given dot 
can use only 4 of the 6 colors. In mixed mode, the 4 lines of text replace the 
bottom 32 rows of dots, leaving 160 rows of 280 dots each. 

The double-high -resolution graphics display uses main and auxiliary 
memory to display an array of dots, 560 wide by 192 high. All the dots are 
visible in black and white. If color is used, the display is 140 dots wide by 
192 high with 16 colors available. In mixed mode, the 4 lines of text replace 
the bottom 32 rows of dots, leaving 160 rows of 560 (or 140) dots each. In 
mixed mode, the text lines can be 80 columns wide only. 



Text Modes 



The text characters displayed include the uppercase and lowercase letters, 
the ten digits, punctuation marks, and special characters. Each character is 
displayed in an area of the screen that is seven dots wide by eight dots high. 
The characters are formed by a dot matrix five dots wide, leaving two blank 
columns of dote between characters in a row, except for MouseText 
characters, some of which are seven dot wide. Except, for lowercase letters 
with descenders and some MouseText characters, the characters are only 
seven dote high, leaving one blank line of dots between rows of characters. 

The normal display has white (or other single color) dots on a black 
background. Characters can also be displayed as black dots on a white 
background; this is called inverse format. 
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Text Character Sets 

The Apple He can display either of two text character sets: the primary set 
or an alternate set. The forms of the characters in the two sets are actually 
the same, but the available display formats are different. The display 
formats are 

p normal, with white dots on a black screen 

□ inverse, with black dots on a white screen 

□ flashing, alternating between normal and inverse. 

With the primary character set, the Apple He can display uppercase 
characters in all three formats: normal, inverse, and flashing. Lowercase 
letters can only be displayed in normal format. The primary character set is 
compatible with most software written for the Apple II and Apple II Plus 
models, which can display text in flashing format but don't have lowercase 
characters. 

The alternate character set displays characters in either normal or inverse 
format. In normal format, you can get 

□ uppercase letters 

□ lowercase letters 
a numbers 

a special characters. 

In inverse format, you can get 

d MouseText characters (on the enhanced Apple He) 

a uppercase letters 

d lowercase letters 

d numbers 

□ special characters. 

The MouseText characters that replace the alternate uppercase inverse 
characters in the range of $40-$5F in the original Apple lie are inverse 
characters, but they don't look like it because of the way that they have 
been constructed. 

You select the character set by means of the alternate text soft switch, 
ALTCHAR, described later in the section "Display Mode Switching." 
Table 2-5 shows the character codes in hexadecimal for the Apple lie 
primary and alternate character sets in normal, inverse, and flashing 
formats. 
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Each character on the screen is stored as one byte of display data. The 
low-order six bits make up the ASCII code of the character being displayed. 
The remaining two (high-order) bits select inverse or flashing format and 
uppercase or lowercase characters. In the primary character set, bit 7 
selects inverse or normal format and bit 6 controls character flashing. In the 
alternate character set, bit 6 selects between uppercase and lowercase, 
according to the ASCII character codes, and flashing format is not available. 

Table 2-5. Display Character Sets 





Note; To identify particular characters and values, refer to Table 2-3. 






Hex 

Values 


Primary Character Set 
Character Type Format 


Alternate Character Set 
Character Type Format 




$00-$lF 


Uppercase letters 


Inverse 


Uppercase letters 


Inverse 




$20-$3F 


Special characters 


Inverse 


Special characters 


Inverse 




$40-$5F 


Uppercase letters 


Flashing 


MouseText 






$60-$7F 


Special characters 


Flashing 


Lowercase letters 


Inverse 




$80-$9F 


Uppercase letters 


Normal 


Uppercase letters 


Normal 




$A0-$BF 


Special characters 


Normal 


Special characters 


Normal 




$C0-$DF 


Uppercase letters 


Normal 


Uppercase letters 


Normal 




$E0-$FF 


Lowercase letters 


Normal 


Lowercase letters 


Normal 


Original lie 


In the alternate character set of the original Apple He, characters in the 
range $40-$5F are uppercase inverse. 




40-Column Versus 80-Column Text 





The Apple He has two modes of text display: 40-column and 80-column. 
(The 80-column display mode described in this manual is the one you get 
with the Apple He 80-Column Text Card or other auxiliary-memory card 
installed in the auxiliary slot.) The number of dots in each character does 
not change, but the characters in 80-column mode are only half as wide as 
the characters in 40-column mode. Compare Figure 2-2 and Figure 2-3. On 
an ordinary color or black-and-white television set, the narrow characters in 
the 80-column display blur together; you must use the 40-column mode to 
display text on a television set. 
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Figure 2-2. 40-Column Text Display 



JUST 0,100 

10 REM APPLESOFT CHARACTER DEMO 

20 TEXT : HOME 

30 PRINT : PRINT "Applesoft char 

acter Demo" 
40 PRINT : PRINT "Which characte 

r set--" 
50 PRINT : INPUT "Primary (P) or 

Alternate (A) ?";At 
60 IF LEN (At) < 1 THEN 50 
65 LET A* - LEFT* (At, 1 J 
70 IF At = "P" THEN POKE 49166, 


80 IF At ■ "A" THEN POKE 49167, 


90 PRINT : PRINT "...printing th 

e same line, first" 
100 PRTNT " in NORMAL, then INVE 

RSE .then FLASH:": PRINT 
] 



Figure 2-3. 80-CoIumn Text Display 



1LIST 



10 

20 
30 
40 

50 

60 

65 

70 

80 

90 

100 

150 

160 

170 

180 

190 

200 

1000 



CHARACTER DEMO 



?" ;A* 



REM APPLESOFT 

TEXT : HOME 

PRINT : PRINT "Applesoft Character Demo" 

PRINT : PRINT "Which character set--" 

PRINT : INPUT "Primary (P) or Alternate CA> 

IF LEN (At) < 1 THEN 50 

LET At ■ LEFT* <At,1> 

IF At - "P" THEN POKE 49166,0 

IF At - "A" THEN POKE 49167,0 

PRINT : PRINT "...printing the same line, first 



PRINT " 
NORMAL 
INVERSE 
FLASH : 
NORMAL 
GET A* 
GOTO 10 
PRINT 



in NORMAL, then 

G05UB 1000 
: GOSUB 1000 
GOSUB 1000 

PRINT : PRINT 



INVERSE ,then FLASH; 



PRINT 



PRINT "Press any key to repeat 



PRINT "SAMPLE TEXT: Now is the time--12:00' 



1 100 RETURN 

m 
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Graphics Modes 

The Apple He can produce video graphics in three different modes. All the 
graphics modes treat the screen as a rectangular array of spots. Normally, 
your programs will use the features of some high-level language to draw 
graphics dots, lines, and shapes in these arrays; this section describes the 
way the resulting graphics data are stored in the Apple He's memory. 

Low-Resolution Graphics 

In the low-resolution graphics mode, the Apple He displays an array of 48 
rows by 40 columns of colored blocks. Each block can be any one of sixteen 
colors, including black and white, On a black-and-white monitor or 
television set, these colors appear as black, white, and three shades of gray. 
There are no blank dots between blocks; adjacent blocks of the same color 
merge to make a larger shape. 

Data for the low-resolution graphics display is stored in the same part of 
memory as the data for the 40-column text display. Each byte contains data 
for two low-resolution graphics blocks. The two blocks are displayed one 
atop the other in a display space the same size as a 40-column text 
character, seven dots wide by eight dots high. 

Half a byte— four bits, or one nibble— is assigned to each graphics block. 
Each nibble can have a value from to 15, and this value determines which 
one of sixteen colors appears on the screen. The colors and their 
corresponding nibble values are shown in Table 2-6. In each byte, the 
low-order nibble sets the color for the top block of the pair, and the 
high-order nibble sets the color for the bottom block. Thus, a byte 
containing the hexadecimal value $D8 produces a brown block atop a 
yellow block on the screen. 



22 



Chapter 2: Built-in I/O Devices 



Table 2-6. Low-Resolution Graphics Colors 



Note: Colors may vary, depending upon the controls on the monitor or TV set. 



Nibble Value 




Dec 


Hex 


Color 





$00 


Black 


I 


$01 


Magenta 


2 


S02 


Dark Blue 


3 


$03 


Purple 


4 


$04 


Dark Green 


5 


S05 


Gray 1 


6 


S06 


Medium Blue 


7 


$07 


Light Blue 



Nibble Value 




Dec 


Hex 


Color 


8 


$08 


Brown 


9 


$09 


Orange 


10 


$0A 


Gray 2 


11 


$0B 


Pink 


12 


$0C 


Light Green 


13 


$00 


Yellow 


14 


$0E 


Aquamarine 


L5 


$0F 


White 



As explained later in the section "Display Pages," the text display and the 
low-resolution graphics display use the same area in memory. Most 
programs that generate text and graphics clear this part of memory when 
they change display modes, but it is possible to store data as text and 
display it as graphics, or vice- versa. All you have to do is change the mode 
switch, described later in this chapter in the section "Display Mode 
Switching," without changing the display data. This usually produces 
meaningless jumbles on the display, but some programs have used this 
technique to good advantage for producing complex low-resolution graphics 
displays quickly. 

High-Resolution Graphics 

In the high-resolution graphics mode, the Apple He displays an array of 
colored dots in 192 rows and 280 columns. The colors available are black, 
white, purple, green, orange, and blue, although the colors of the individual 
dots are limited, as described later in this section. Adjacent dots of the same 
color merge to form a larger colored area. 

Data for the high-resolution graphics displays are stored in either of two 
8192 byte areas in memory. These areas are called high- resolution Page 1 
and Page 2; think of them as buffers where you can put data to be 
displayed. Normally, your programs will use the features of some high-level 
language to draw graphics dots, lines, and shapes to display; this section 
describes the way the resulting graphics data are stored in the Apple He's 
memory. 
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Figure 2-4. High-Resolution Display 
Bits 



Bits in Data Byte 
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Dots on Graphics Screen 



For more details about the way the 
Apple ile produces color on a TV set, see 
the section "Video Display Modes" in 

Chapter?, 



The Apple lie high-resolution graphics display is bit-mapped: each dot on 
the screen corresponds to a bit in the Apple He's memory . The seven 
low-order bits of each display byte control a row of seven adjacent dots on 
the screen, and forty adjacent bytes in memory control a row of 280 
(7 times 40) dots, The least significant bit of each byte is displayed as the 
leftmost dot in a row of seven, followed by the second-least significant bit, 
and so on, as shown in Figure 2-4. The eighth bit (the most significant) of 
each byte is not displayed; it selects one of two color sets, as described later. 

On a black-and-white monitor, there is a simple correspondence between 
bits in memory and dots on the screen. A dot is white if the bit controlling it 
is on (1), and the dot is black if the bit is off (0). On a black-and-white 
television set, pairs of dots blur together; alternating black and white dots 
merge to a continuous grey. 

On an NTSC color monitor or a color television set, a dot whose controlling 
bit is off (0) is black. If the bit is on, the dot will be white or a color, 
depending on its position, the dots on either side, and the setting of the 
high-order bit of the byte, 

Call the left-most column of dots column zero, and assume (for the moment) 
that the high-order bits of all the data bytes are off (0). If the bits that 
control dots in even-numbered columns (0, 2, 4, and so forth) are on, the 
dots are purple; if the bits that control odd-numbered columns are on, the 
dots are green— but only if the dots on both sides of a given dot are black. If 
two adjacent dots are both on, they are both white. 

You select the other two colors, blue and orange, by turning the high-order 
bit (bit 7) of a data byte on (1). The colored dots controlled by a byte with 
the high-order bit on are either blue or orange: the dots in even-numbered 
columns are blue, and the dots in odd-numbered columns are orange— 
again, only if the dots on both sides are black. Within each horizontal line of 
seven dots controlled by a single byte, you can have black, white, and one 
pair of colors. To change the color of any dot to one of the other pair of 
colors, you must change the high-order bit of its byte, which affects the 
colors of all seven dots controlled by the byte. 

In other words, high-resolution graphics displayed on a color monitor or 
television set are made up of colored dots, according to the following rules: 

□ Dots in even columns can be black, purple, or blue. 

□ Dots in odd columns can be black, green, or orange. 

□ If adjacent dots in a row are both on, they are both white. 

d The colors in each row of seven dots controlled by a single byte are either 
purple and green, or blue and orange, depending on whether the 
high-order bit is off (0) or on (1). 
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These rules are summarized in Table 2-7. The blacks and whites are 
numbered to remind you that the high-order bit is different. 



Table 2-7. High-Resolution Graphics Colors 



Note: Colors may vary 


depending upon the cor 


Urols on the monitor or television 


set. 






Bits 0-6 


Bit 7 Off 


Bit 7 On 


Adjacent columns off 


Black 1 


Black 2 


Even columns on 


Purple 


Blue 


Odd columns on 


Green 


Orange 


Adjacent columns on 


White 1 


White 2 



For information about the way NTSC color 
television works, see the magazine articles 
listed in the bibliography. 



The peculiar behavior of the high-resolution colors reflects the way NTSC 
color television works. The dots that make up the Apple He video signal are 
spaced to coincide with the frequency of the color subcarrier used in the 
NTSC system. Alternating black and white dots at this spacing cause a 
color monitor or TV set to produce color, but two or more white dots 
together do not. 



Double-Hig h-Resolution Graphics 

Double-high-resolution graphics is a bit-mapping of the low-order seven bits 
of the bytes in the main-memory and auxiliary-memory pages at 
$2000-$3FFF. The bytes in the main-memory and auxiliary-memory pages 
are interleaved in exactly the same manner as the characters in 80-column 
text: of each pair of identical addresses, the auxiliary-memory byte is 
displayed first, and the main-memory byte is displayed second. Horizontal 
resolution is 560 dots when displayed on a monochrome monitor. 

Unlike high-resolution color, double-high-resolution color has no restrictions 
on which colors can be adjacent. Color is determined by any four adjacent 
dots along a line. Think of a 4-dot-wide window moving across the screen: at 
any given time, the color displayed will correspond to the 4-bit value from 
Table 2-8 that corresponds to the window's position (Figure 2-9). Effective 
horizontal resolution with color is 140 (560 divided by four) dots per line. 

To use Table 2-8, divide the display column number by 4, and use the 
remainder to find the correct column in the table: abO is a byte residing in 
auxiliary memory corresponding to a remainder of (byte 0, 4, 8, and so on); 
mhl is a byte residing in main memory corresponding to a remainder of 1 
(byte 1, 5, 9 and so on), and similarly for ab3 and mb4. 
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Table 2-8. Double-High-Resolution Graphics Colors 



Color 


abO 


mbl 


ab2 


ntb3 


Repeated 
Bit Pattern 


Black 


$00 


$00 


$00 


$00 


0000 


Magenta 


$08 


$11 


$22 


$44 


0001 


Brown 


$44 


$08 


$11 


$22 


0010 


Orange 


$4C 


$19 


$33 


$66 


0011 


Dark Green 


$22 


$44 


$08 


$11 


0100 


Gray 1 


$2A 


$55 


$2A 


$55 


0101 


Green 


$66 


$4C 


$19 


$33 


0110 


Yellow 


S6E 


$5D 


$3B 


$77 


0111 


Dark Blue 


$11 


$22 


$44 


$08 


1000 


Purple 


$19 


$33 


$66 


$4C 


1001 


Gray 2 


$55 


$2A 


$55 


$2A 


1010 


Pink 


$5D 


$3B 


$77 


$6E 


1011 


Medium Blue 


$33 


$66 


$4C 


$19 


1100 


Light Blue 


$3B 


$77 


$6E 


$5D 


1101 


Aqua 


$77 


$6E 


$5D 


$3B 


1110 


White 


$7F 


$7F 


$7F 


$7F 


mi 



Video Display Pages 

The Apple He generates its video displays using data stored in specific areas 
in memory. These areas, called display pages, serve as buffers where your 
programs can put data to be displayed. Each byte in a display buffer 
controls an object, at a certain location on the display. In text mode, the 
object is a single character; in low-resolution graphics, the object is two 
stacked colored blocks; and in high-resolution and double-high-resolution 
modes, it is a line of seven adjacent dots. 
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The 40-column-text and low-resolution-graphics modes use two display 
pages of 1024 bytes each, These are called text Page 1 and text Page 2, and 
they are located at 1024-2047 (hexadecimal S0400-$07FF) and 2048-3071 
($0800-$0BFF) in main memory. Normally, only Page 1 is used, but you can 
put text or graphics data into Page 2 and switch displays instantly. Either 
page can be displayed as 40-column text, low-resolution graphics, or 
mixed-mode (four rows of text at the bottom of a graphics display). 

The 80-column text mode displays twice as much data as the 40-column 
mode— 1920 bytes— but it cannot switch pages. The 80-column text display 
uses a combination page made up of text Page 1 in main memory plus 
another page in auxiliary memory located on the 80-column text card. This 
additional memory is not the same as text Page 2— in fact, it occupies the 
same address space as text Page 1, and there is a special soft switch that 
enables you to store data into it. (See the next section "Display Mode 
Switching.") The built-in firmware I/O routines described in Chapter 3 take 
care of this extra addressing automatically; that is one reason to use those 
routines for all your normal text output. 

The high-resolution graphics mode also has two display pages, but each 
page is 8192 bytes long. In the 40-column text and low-resolution graphics 
modes each byte controls a display area seven dots wide by eight dots high. 
In high-resolution graphics mode each byte controls an area seven dots wide 
by one dot high. Thus, a high-resolution display requires eight times as 
much data storage, as shown in Table 2-9. 

The double-high-resolution graphics mode uses high-resolution Page 1 in 
both main and auxiliary memory. Each byte in those pages of memory 
controls a display area seven dots wide by one dot high. This gives you 560 
dots per line in black and white, and 140 dots per line in color. A 
double-high-resolution display requires twice the total memory as 
high-resolution graphics, and 16 times as much as a low-resolution display. 
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Table 2-9. Video Display Page Locations 



Display Mode 


Display 

Page 


Lowest Address 
Hex Dec 


Highest Address 
Hex Dec 


40-column text, 
low-resolution graphics 


1 

2* 


$0400 
$0800 


1024 
2048 


$07FF 
$0BFF 


2047 

3071 


80-column text 


1 

2* 


$0400 
$0800 


1024 
2048 


$07FF 
S0BFF 


2047 
3071 


High-resolution 
graphics 


1 
2 


$2000 
$4000 


8192 
16384 


S3FFF 
$5FFF 


16383 
24575 


Double-high- 
resolution graphics 


It 
2f 


$2000 
$4000 


8192 
16384 


$3FFF 
$5FFF 


16383 
24575 



* This is not supported by firmware; for instructions on how to switch pages, refer to the 
next section "Display Mode Switching." 

t See the section "Double-High-Resolution Graphics," earlier in this chapter. 



Display Mode Switching 

You select the display mode that is appropriate for your application by 
reading or writing to a reserved memory location called a soft switch, In the 
Apple lie, most soft switches have three memory locations reserved for 
them: one for turning the switch on, one for turning it off, and one for 
reading the current state of the switch. 

Table 2-10 shows the reserved locations for the soft switches that control 
the display modes. For example, to switch from mixed-mode to full-screen 
graphics in an assembly-language program, you could use the instruction 



STA 



$C052 



To do this in a BASIC program, you could use the instruction 

POKE 49234,0 

Some of the soft switches in Table 2-10 must be read, some must be written 
to, and for some you can use either action. When writing to a soft switch, it 
doesn't matter what value you write; the action occurs when you address 
the location, and the value is ignored. 



38 



Chapter 2: Built-in I/O Devices 



Table 2-10. Display Soft Switches 



Note: W means write anything to the location, R means read the location, R/W 
means read or write, and R7 means read the location and then check bit 7. 

Name Action Hex Function 

ALTCHAR W $C00E Off: display text using primary character set 
ALTCHAR W $C00F On: display text using alternate character set 
RDALTCHAR R7 IC01E Read ALTCHAR switch (1 = on) 


80COL 
80COL 
RD80COL 


W 

w 

R7 


$CO0C 
SCOOD 
SC01F 


Off: display 40 columns 
On: display 80 columns 
Read 80COL switch (1 = on) 


80STORE 
80STORE 
RD80STORE 


W 

w 

R7 


scooo 

SC001 
$C018 


Off: cause PAGE2 on to select auxiliary RAM 
On: allow PAGE2 to switch main RAM areas 
Read 80STORE switch (1 = on) 


PAGE2 

PAGE2 

RDPAGE2 


R/W 
R/W 

R7 


$C054 
$C055 

SC01C 


Off: select Page 1 

On: select Page 2 or, if 80STORE on, Page 1 in 

auxiliary memory 

Read PAGE2 switch (1 = on) 


TEXT 
TEXT 
RDTEXT 


R/W 
R/W 
R7 


SC050 
SC051 

SC01A 


Off: display graphics or, if MIXED on, mixed 

On: display text 

Read TEXT switch (1 = on) 


MIXED 
MIXED 
RDMIXED 


R/W 

R/W 
R7 


SC052 
$C053 
SC01B 


Off: display only text or only graphics 
On: if TEXT off' display text and graphics 
Read MIXED switch (1 = on) 


HIRES 
HIRES 

RDHIRES 


R/W^ 
R/W 

R7 


SG056 
$0057 

SC01D 


Off: if TEXT off, display low-resolution graphics 
On: if TEXT off, display high-resolution or, if 
DHIRES on, double-high-resolution graphics 
Read HIRES switch (1 = on) 


I0UD1S 
I0UDIS 
RDIOUDIS 


W 
W 

R7 


SC07E 
$C07F 
SC07E 


On: disable IOU access for addresses $C058 to 
$C05F; enable access to DHIRES switch * 
Off: enable IOU access for addresses SC058 to 
$C05F; disable access to DHIRES switch * 
Read IOUDIS switch (1 = off) t 



DHIRES R/W SC05E 

DHIRES R/W $C05F 

RDDHIRES R7 $C07F 



On: if IOUDIS on, turn on double-high-res. 
Off: if IOUDIS on, turn off double-high-res. 
Read DHIRES switch (1 = on) t 



* The firmware normally leaves IOUDIS on. See also t. 

t Reading or writing any address in the range $C070-$C07F also triggers the paddle timer 
and resets VBLINT (Chapter 7). 
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For a full description of the way the 
Apple He handles its display memory, refer 
to the section "Display Memory 
Addressing" in Chapter 7. 



By the Way: You may not need to deal with these functions by reading 
and writing directly to the memory locations in Table 2-10. Many of the 
functions shown here are selected automatically if you use the display 
routines in the various high-level languages on the Apple He. 

Any time you read a soft switch, you get a byte of data. However, the only 
information the byte contains is the state of the switch, and this occupies 
only one bit— bit 7, the high-order bit. The other bits in the byte are 
unpredictable, If you are programming in machine language, the switch 
setting is the sign bit; as soon as you read the byte, you can do a Branch 
Plus if the switch is off, or Branch Minus if the switch if on. 

If you read a soft switch from a BASIC program, you get a value between 
and 255. Bit 7 has a value of 128, so if the switch is on, the value will be 
equal to or greater than 128; if the switch is off, the value will be less 
than 128. 



Addressing Display Pages Directly 

Before you decide to use the display pages directly, consider the 
alternatives. Most high-level languages enable you to write statements that 
control the text and graphics displays. Similarly, if you are programming in 
assembly language, you may be able to use the display features of the 
built-in I/O firmware. You should store directly into display memory only if 
the existing programs can't meet your requirements. 

The display memory maps are shown in Figures 2-5, 2-6, 2-7, 2-8, and 2-9. 
All of the different display modes use the same basic addressing scheme: 
characters or graphics bytes are stored as rows of 40 contiguous bytes, but 
the rows themselves are not stored at locations corresponding to their 
locations on the display, Instead, the display address is transformed so that 
three rows that are eight rows apart on the display are grouped together and 
stored in the first 120 locations of each block of 128 bytes ($80 
hexadecimal). By folding the display data into memory this way, the 
Apple lie, like the Apple II, stores all 960 characters of displayed text within 
IK bytes of memory. 
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For more details about the way the displays 
are generated, see Chapter 7. 



The high-resolution graphics display is stored in much the same way as 
text, but there are eight times as many bytes to store, because eight rows of 
dots occupy the same space on the display as one row of characters. The 
subset consisting of all the first rows from the groups of eight is stored in 
the first 1024 bytes of the high-resolution display page. The subset 
consisting of all the second rows from the groups of eight is stored in the 
second 1024 bytes, and so on for a total of 8 times 1024, or 8192 bytes. In 
other words, each block of 1024 bytes in the high-resolution display page 
contains one row of dots out of every group of eight rows. The individual 
rows are stored in sets of three 40-byte rows, the same way as the text 
display. 

All of the display modes except 80-column mode and double-high-resolution 
graphics mode can use either of two display pages. The display maps show 
addresses for each mode's Page 1 only. To obtain addresses for text or 
low-resolution graphics Page 2, add 1024 ($400); to obtain addresses for 
high-resolution Page 2, add 8192 ($2000). 

The 80-column display and double-high-resolution graphics mode work a 
little differently. Half of the data is stored in the normal text Page-1 
memory, and the other half is stored in memory on the 80-column text card 
using the same addresses. The display circuitry fetches bytes from these 
two memory areas simultaneously and displays them sequentially: first the 
byte from the 80-column text card memory, then the byte from the main 
memory. The main memory stores the characters in the odd columns of the 
display, and the 80-column text card memory stores the characters in the 
even columns. 

To store display data on the 80-column text card, first turn on the 80STORE 
soft switch by writing to location 49153 (hexadecimal $C001 or 
complementary -16383). With 80STORE on, the page-select switch, PAGE2, 
selects between the portion of the 80-column display stored in Page 1 of 
main memory and the portion stored in the 80-column text card memory. To 
select the 80-column text card, turn the PAGE2 soft switch on by reading or 
writing at location 49237. 
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Figure 2-5. Map of 40-CoIumn Text Display 
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Figure 2-6. Map of 80-Column Text Display 
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Figure 2-7, Map of Low-Resolution Graphics Display 
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Figure 2-8. Map of High-Resolution Graphics Display 
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Figure 2-9. Map of Double-High- Resolution Graphics Display 
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Secondary Inputs and Outputs 



Important! 



In addition to the primary I/O devices— the keyboard and display— there 
are several secondary input and output devices in the Apple lie. These 
devices are 

□ the speaker (output) 

□ cassette input and output 

□ annunciator outputs 
a strobe output 

d switch inputs 

□ analog (hand control) inputs. 

These devices are similar in operation to the soft switches described in the 
previous section: you control them by reading or writing to dedicated 
memory locations. Action takes place any time your program reads or 
writes to one of these locations; information written is ignored, 

Some of these devices toggle— change state— each time they are 
accessed. If you write using an indexed store operation, the Apple He's 
microprocessor activates the address bus twice during successive clock 
cycles, causing a device that toggles each time it is addressed to end up 
back in its original state. For this reason, you should read, rather than 
write, to such devices. 



Electrical specifications of the speaker 
circuit appear in Chapter 7, 



The Speaker 

The Apple He has a small speaker mounted toward the front of the bottom 
plate. The speaker is connected to a soft switch that toggles; it has two 
states, off and on, and it changes from one to the other each time it is 
accessed. (At low frequencies, less than 400 Hz or so, the speaker clicks 
only on every other access.) 

If you switch the speaker once, it emits a click; to make longer sounds, you 
access the speaker repeatedly. You should always use a read operation to 
toggle the speaker. If you write to this soft switch, it switches twice in rapid 
succession. The resulting pulse is so short that the speaker doesn't have 
time to respond; it doesn't make a sound. 



Secondary Inputs and Outputs 
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BELLI is described in Appendix B. 



The soft switch for the speaker uses memory location 49200 (hexadecimal 
$C030), From Integer BASIC, use the complementary address -16336. You 
can make various tones and buzzes with the speaker by using combinations 
of timing loops in your program. There is also a routine in the built-in 
firmware to make a beep through the speaker. This routine is called BELLI. 



Detailed electrical specifications for the 
cassette input and output are given in 
Chapter 7. 



WRITE is described in Appendix B. 



Cassette Input and Output 

There are two miniature phone jacks on the back panel of the Apple He. You 
can use a pair of standard cables with miniature phone plugs to connect an 
ordinary cassette tape recorder to the Apple He and save programs and data 
on audio cassettes. 

The phone jack marked with a picture of an arrow pointing towards a 
cassette is the output jack. It is connected to a toggled soft switch, like the 
speaker switch described above. The signal at the phone jack switches from 
zero to 25 millivolts or from 25 millivolts to zero each time you access the 
soft switch. 

If you connect a cable from this jack to the microphone input of a cassette 
tape recorder and switch the recorder to record mode, the signal changes 
you produce by accessing this soft switch will be recorded on the tape. The 
cassette output switch uses memory location 49184 (hexadecimal SC020; 
complementary value -16352). Like the speaker, this output will toggle 
twice if you write to it, so you should only use read operations to control the 
cassette output. 

The standard method for writing computer data on audio tapes uses tones 
with two different pitches to represent the binary states zero and one. To 
store data, you convert the data into a stream of bits and convert the bits 
into the appropriate tones. To save you the trouble of actually programming 
the tones, and to ensure consistency among all Apple II cassette tapes, there 
is a built-in routine called WRITE for producing cassette data output. 
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READ is described in Appendix B, 



The phone jack marked with a picture of an arrow coming from a cassette is 
the input jack. It accepts a cable from the cassette recorder's earphone jack. 
The signal from the cassette is 1 volt (peak-to-peak) audio. Each time the 
instantaneous value of this audio signal changes from positive to negative, 
or vice-versa, the state of the cassette input circuit changes from zero to one 
or vice-versa. You can read the state of this circuit at memory location 
49248 (hexadecimal $C060, or complementary decimal -16288). 

When you read this location, you get a byte, but only the high-order bit 
(bit 7) is valid. If you are programming in machine language, this is the sign 
bit, so you can perform a Branch Plus or Branch Minus immediately after 
reading this byte. BASIC is too slow to keep up with the audio tones used for 
data recording on tape, but you don't need to write the program: there is a 
built-in routine called READ for reading data from a cassette. 



Complete electrical specifications of these 
inputs and outputs are given in Chapter 7. 



The Hand Control Connector Signals 

Several inputs and outputs are available on a 9-pin D-type miniature 
connector on the back of the Apple He: three one-bit inputs, or switches, 
and four analog inputs. These signals are also available on the 16-pin IC 
connector on the main circuit board, along with four one-bit outputs and a 
data strobe. You can access all of these signals from your programs. 

Ordinarily, you connect a pair of hand controls to the 9-pin connector. The 
rotary controls use two analog inputs, and the push-buttons use two one-bit 
inputs, However, you can also use these inputs and outputs for many other 
jobs. For example, two analog inputs can be used with a two-axis joystick. 
Table 7-19 shows the connector pin numbers. 



Second an Inputs and Outputs 



For electrical specifications of the 
annunciator outputs, refer to Chapter 7. 



Annunciator Outputs 

The four one-bit outputs are called annunciators. Each annunciator can be 
used to turn a lamp, a relay, or some similar electronic device on and off. 

Each annunciator is controlled by a soft switch, and each switch uses a pair 
of memory locations. These memory locations are shown in Table 2-11. 
Any reference to the first location of a pair turns the corresponding 
annunciator off; a reference to the second location turns the annunciator 
on. There is no way to read the state of an annunciator. 



Table 2-1 1. Annunciator Memory Locations 





Annunciator 




Address 




No. 


Pin* 


State 


Decimal 


Hex 





15 


off 


49240 


-16296 


SC058 






on 


49241 


-16295 


SC059 


1 


14 


off 


49242 


-16294 


SC05A 






on 


49243 


-16293 


$C05B 


2 


13 


off 


49244 


-16292 


$C05C 






on 


49245 


-16291 


$C05D 


3 


12 


off 


49246 


-16290 


SC05E 






on 


49247 


-16289 


$C05F 



* Pin numbers given are for the 16-pin IC connector on the circuit board. 

Strobe Output 

The strobe output is normally at +5 volts, but it drops to zero for about half 
a microsecond any time its dedicated memory location is accessed. You can 
use this signal to control functions such as data latching in external devices. 
If you use this signal, remember that memory is addressed twice by a write; 
if you need only a single pulse, use a read operation to activate the strobe. 
The memory location for the strobe signal is 49216 (hexadecimal $C040 or 
complementary -16320). 
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▲Warning 



Switch Inputs 

The three one-bit inputs can be connected to the output of another 
electronic device or to a pushbutton. When you read a byte from one of 
these locations, only the high-order bit— bit 7— is valid information; the rest 
of the byte is undefined. From machine language, you can do a Branch Plus 
or Branch Minus on the state of bit 7. From BASIC, you read the switch with 
a PEEK and compare the value with 128. If the value is 128 or greater, the 
switch is on. 

The memory locations for these switches are 49249 through 49251 
(hexadecimal $C061 through $C063, or complementary -16287 through 
-16285), as shown in Table 2-12. Switch and switch 1 are permanently 
connected to the [5] and [I] keys on the keyboard; these are the ones 
normally connected to the buttons on the hand controls. Some software for 
the older models of the Apple II uses the third switch, switch 2, as a way of 
detecting the shift key. This technique requires a hardware modification 
known as the single-wire shift-key mod. 

You should be sure that you really need the shift-key mod before you go 
ahead and do it. It probably is not worth it unless you have a program that 
requires the shift-key mod that you cannot either replace or modify to work 
without it. 

If you make the shift-key modification and connect a joystick or other 
hand control that uses switch 2, you must be careful never to close the 
switch and press | shift I at the same time: doing so produces a short 
circuit that causes the power supply to turn off. When this happens, any 
programs or data in the computer's internal memory are lost. 

Shift-Key Mod; To perform this modification on your Apple He, all you 
have to do is solder across the broken diamond labelled X6 on the main 
circuit board. Remember to turn off the power before changing anything 
inside the Apple He. Also remember that changes such as this are at your 
own risk and may void your warranty. 
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Refer to the section "Game J/0 Signals" in 
Chapter 7 for detaiis. 



PREAD is described in Appendix B, 



Analog Inputs 

The four analog inputs are designed for use with 150K ohm variable 
resistors or potentiometers. The variable resistance is connected between 
the +5V supply and each input, so that it makes up part of a timing circuit. 
The circuit changes state when its time constant has elapsed, and the time 
constant varies as the resistance varies. Your program can measure this 
time by counting in a loop until the circuit changes state, or times out. 

Before a program can read the analog inputs, it must first reset the timing 
circuits. Accessing memory location 49264 (hexadecimal $C070 or 
complementary -16272) does this. As soon as you reset the timing circuits, 
the high bits of the bytes at locations 49252 through 49255 (hexadecimal 
$C064 through $C067 or complementary -16284 through -16281) are set to 1. 
If you PEEK at them from BASIC, the values will be 128 or greater. Within 
about 3 milliseconds, these bits will change back to 0— byte values less 
than 128— and remain there until you reset the timing circuits again, The 
exact time each of the four bits remains high is directly proportional to the 
resistance connected to the corresponding input. If these inputs are open- 
no resistances are connected— the corresponding bits may remain high 
indefinitely. 

To read the analog inputs from machine language, you can use a program 
loop that resets the tuners and then increments a counter until the bit at the 
appropriate memory location changes to 0, or you can use the built-in 
routine called PREAD. High-level languages, such as BASIC, also include 
convenient means of reading the analog inputs: refer to your language 
manuals. 



Summary of Secondary I/O L ocations 

Table 2-12 shows the memory locations for all of the built-in I/O devices 
except the keyboard and display. As explained earlier, some soft switches 
should only be accessed by means of read operations; those switches are 
marked. 
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Table 2-12. Secondary I/O Memory Locations 



For connector identifier 


Hon and pin numbers, refei 


*to Tables 7-18 and 7-19. 




Address 






Function 


Decimal 




Hex 


Access 


Speaker 


49200 -i 


6336 


$C030 


Read only 


Cassette out 
Cassette in 


49184 ■] 
49248 -] 


6352 
6288 


$C020 
SC060 


Read only 
Read only 


Annunciator on 
Annunciator off 


49241 -] 
49240 -] 


[6295 

L6296 


$C059 
SC058 




Annunciator 1 on 
Annunciator 1 off 


49243 -: 

49242 


16293 
16294 


SC05B 
$C05A 




Annunciator 2 on 
Annunciator 2 off 


49245 

49244 


16291 
16292 


$C05D 
$C05C 




Annunciator 3 on 
Annunciator 3 off 


49247 
49246 


16289 
L6290 


SC05F 
$C05E 




Strobe output 


49216 


16320 


$C040 


Read only 


Switch input ({&}) 
Switch input 1 ([¥]) 
Switch input 2 


49249 
49250 
49251 


16287 
16286 
16285 


SC061 
$C062 
$C063 


Read only- 
Read only 
Read only 


Analog input reset 


49264 


16272 


$C070 




Analog input 
Analog input 1 
Analog input 2 
Analog input 3 


49252 
49253 
49254 
49255 


16284 
16283 
16282 
16281 


$C064 
$C065 
SC066 
$C067 


Read only 
Read only 
Read only 
Read only 
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Chapter 3 



Built-in I/O Firmware 
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The Monitor, or System Monitor, is a 
computer program that is used to operate 
the computer at the machine language 
level. 



Important! 



Almost every program on the Apple He takes input from the keyboard and 
sends output to the display. The Monitor and the Applesoft, and Integer 
BASICs do this by means of standard I/O subroutines that are built into the 
Apple He's firmware. Many application programs also use the standard I/O 
subroutines, but Pascal programs do not; Pascal has its own I/O 
subroutines. 

This chapter describes the features of these subroutines as they are used by 
the Monitor and by the BASIC interpreters, and tells you how to use the 
standard subroutines in your assembly-language programs. 

High-level languages already include convenient methods for handling 
most of the functions described in this chapter. You should not need to 
use the standard I/O subroutines in your programs unless you are 
programming in assembly language. 



Ta ble 3-1. Monitor Firmware Routines 



Location 


Name 


SC305 


BASIGIN 


SC307 


BASICOUT 


SFC9C 


CLREOL 


SFC9E 


CLEOIZ 


$FC42 


CLREOP 


SF832 


CLRSCR 


$F836 


CLRTOP 


$FDED 


GOUT 


$FDF0 


COUT1 


$FD8E 


GROUT 


$FD8B 


CROUT1 



$FD6A 

$F819 

$FC58 



GETLN 

HLINE 
HOME 



Description 

With 80-column dirmware active, displays solid, 
blinking cursor. Accepts character from keyboard. 

Displays a character on the screen; used when the 
80-column firmware is active (Chapter 3). 

Clears to end of line from current cursor position. 

Clears to end of line using contents of Y register as 
cursor position. 

Clears to bottom of window. 

Clears the low-resolution screen. 

Clears top 40 lines of low-resolution screen. 

Calls output routine whose address is stored in CSW 
(normally COUT1, Chapter 3). 

Displays a character on the screen (Chapter 3). 

Generates a carriage return character. 

Clears to end of line, then generates a carriage return 
character. 

Displays the prompt character; accepts a string of 
characters by means of RDKEY. 

Draws a horizontal line of blocks. 

Clears the window and puts cursor in upper-left 
corner of window. 
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Table 3-1 — Continued. Monitor Firmware Routines 



Location Name 

SFD1B KEYIN 



■ 

■ 



SF800 

$F94A 

$FDDA 

$FF2D 

$FDE3 

IF941 

$FD0C 

IF871 
$F864 
$FC24 
$F828 



PLOT 

PRBL2 

PRBYTE 

PRERR 

PRHEX 

PRNTAX 

RDKEY 

SCRN 
SETCOL 
VTABZ 
VLINE 



Description 

With 80-column firmware inactive, displays 
checkerboard cursor. Accepts character from 
keyboard. 

Plots a single low-resolution block on the screen. 

Sends 1 to 256 blank spaces to the output device. 

Prints a hexadecimal byte. 

Sends err and Control-G to the output device. 

Prints 4 bits as a hexadecimal number. 

Prints contents of A and X in hexadecimal. 

Displays blinking cursor; goes to standard input 
routine, normally KEYIN or BAS1CIN. 

Reads color value of a low-resolution block. 

Sets the color for plotting in low-resolution. 

Sets cursor vertical position. 

Draws a vertical line of low-resolution blocks. 



AUXMOVE and XFER are described in the 
section "Auxiliary-Memory Subroutines" in 
Chapter 4 



The standard I/O subroutines listed in Table 3-1 are fully described in this 
chapter. The Apple He firmware also contains many other subroutines that 
you might find useful. Those subroutines are described in Appendix B. Two 
of the built-in subroutines, AUXMOVE and XFER, can help you use the 
optional auxiliary memory. 



Using the I/O Subroutines 



Before you use the standard I/O subroutines, you should understand a little 
about the way they are used. The Apple He firmware operates differently 
when an option such as an 80-column text card is used. This section 
describes general situations that affect the operation of the standard I/O 
subroutines. Specific instances are described in the sections devoted to the 
individual subroutines. 
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Apple II Compatibility 

Compared to older Apple II models, the Apple He has some additional 
keyboard and display features. To run programs that were written for the 
older models, you can make the Apple lie resemble an Apple II Plus by 
turning those features off. The features that you can turn off and on to put 
the Apple lie into and out of Apple II mode are listed in Table 3-2. 



Table 3-2. Apple II Mode 



Apple He 

Keyboard Uppercase and lowercase 

Display characters Inverse and normal only 

Display size 40-column; also 80-column 

with optional card 



Apple II Mode 

Uppercase only 

Flashing, inverse, and 
normal 

40-column onlv 



Original He 



The primary and alternate character sets 
are described in Chapter 2 in the section 
"Text Character Sets." 



Original He 



The ALTCHAR soft switch is described in 
Chapter 2. 



If the Apple He does not have an 80-column text card installed in the 
auxiliary slot, it is almost in Apple II mode as soon as you turn it on or reset 
it. One exception is the keyboard, which is both uppercase and lowercase. 

On an original Apple He, DOS 3.3 commands and statements in Integer 
BASIC and Applesoft must be typed in uppercase letters. To be 
compatible with older software, you should switch the Apple lie keyboard 
to uppercase by pressing Icaps lock] . 

Another feature that is different on the Apple He as compared to the 
Apple 11 is the displayed character set. An Apple II displays only uppercase 
characters, but it displays them three ways: normal, inverse, and flashing. 
The Apple lie can display uppercase characters all three ways, and it can 
display lowercase characters in the normal way. This combination is called 
the primary character set, When the Apple lie is first turned on or reset, 
it displays the primary character set. 

The Apple lie has another character set, called the alternate character 
set, that displays a full set of normal and inverse characters, with the 
inverse uppercase characters between $40 and $5F replaced on enhanced 
Apple lie's with MouseText characters. 

In the original Apple lie, uppercase inverse characters appear in place of 
the MouseText characters of the enhanced Apple He and the Apple He. 

You can switch character sets at any time by means of the ALTCHAR soft 
switch. 
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■ 

■ 
■ 
■ 



See the section "Switching I/O Memory" in 
Chapter 6 for details. 



Important! 



SLOTC3ROM is described in Chapter 6 in 
the section "Switching I/O Memory." 



■ For more information about interrupts, see 
Chapter 6. 



The 80 -C otumn Firmware 

There are a few features that are normally available only with the optional 
80-column display. These features are identified in Table 3-3b and 
Table 3-6, The firmware that supports these features is built into the 
Apple He, but it is normally active only if an 80-column text card is installed 
in the auxiliary slot. 

When you turn on power or reset the Apple He, the 80-column firmware is 
inactive and the Apple He displays the primary character set, even if an 
80-column text card is installed. When you activate the 80-column 
firmware, it switches to the alternate character set. 

The built-in 80-column firmware is implemented as if it were installed in 
expansion slot 3. Programs written for an Apple II or Apple II Plus with an 
80-column text card installed in slot 3 usually will run properly on a 
Apple He with an 80-column text card in the auxiliary slot. 

If the Apple He has an 80-column text card and you want to use the 
80-column display, you can activate the built-in firmware from BASIC by 
typing 

PR*3 

To activate the 80-column firmware from the Monitor, press (T), then 
1 control H ~p~]. Notice that this is the same procedure you use to activate a 
card in expansion slot 3. Any card installed in the auxiliary slot takes 
precedence over a card installed in expansion slot 3: 

Even though you activated the 80-column firmware by typing PR#3, you 
should never deactivate it by typing PR#0, because that just disconnects 
the firmware, leaving several soft switches still set for 80-column 
operation. Instead, type the sequence I esc 1 1 control rfol . (See 
Table 3-6.) 

If there is no 80-column text card or other auxiliary memory card in your 
Apple He, you can still activate the 80-column firmware and use it with a 
40-column display. First, set the SLOTC3ROM soft switch located at $C00A 
(49162). Then type PR#3 to transfer control to the firmware. 

When the 80-column firmware is active without a card in the auxiliary slot, 
it does not work quite the same as it does with a card. The functions that 
clear the display (CLREOL, CLEOLZ, CLREOP, and HOME) work as if the 
firmware were inactive; they always clear to the current color. Also, 
interrupts are supported only with a card installed in the auxiliary slot. 
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▲Warning 



If you do not have an interface card in either the auxiliary slot or slot 3, 
don't try to activate the firmware with PR#3. Typing PR#3 with no card 
installed transfers control to the empty connector, with unpredictable 

results. 

Programs activate the 80-column firmware by transferring control to 
address SC300. If there is no card in the auxiliary slot, you must set the 
SLOTC3ROM soft switch first. To deactivate the 80-column firmware from a 
program, write a Control-U character via subroutine GOUT. 

The Old Monitor 

Apple IPs and Apple II Pluses used a version of the System Monitor 
different from the one the Apple lie uses. It had the same standard I/O 
subroutines, but a few of the features were different; for example, there 
were no arrow keys for cursor motion. If you start the Apple He with a DOS 
or BASIC disk that loads Integer BASIC into the bank-switched area in 
RAM, the old Monitor (sometimes called the Autostart Monitor) is also 
loaded with it. When you type INT from Applesoft to activate Integer 
BASIC, you also activate this copy of the old Monitor, which remains active 
until you either type FP to switch back to Applesoft, which uses the new 
Monitor in ROM, or type 

PR#3 

to activate the 80-column firmware. Part of the firmware's initialization 
procedure checks to see which version of the Monitor is in RAM. If it finds 
the old Monitor, it replaces it with a copy of the new Monitor from ROM. 
After the firmware has copied the new Monitor into RAM, it remains there 
until the next time you start up the system. 



The Standard I/O Links 

When you call one of the character I/O subroutines (COUT and RDKEY), 
the first thing that happens is an indirect jump to an address stored in 
programmable memory. Memory locations used for transferring control to 
other subroutines are sometimes called vectors; in this manual, the 
locations used for transferring control to the I/O subroutines are called I/O 
links. In a Apple He running without a disk operating system, each I/O link 
is normally the address of the body of the subroutine (COUT1 or KEYIN). If 
a disk operating system is running, one or both of these links hold the 
addresses of the corresponding DOS or ProDOS I/O routines instead. (DOS 
and ProDOS maintain their own links to the standard I/O subroutines.) 
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For more information about the I/O links, 
see the section "Changing the Standard I/O 
Links" in Chapter 6. 



By calling the I/O subroutines that jump to the link addresses instead of 
calling the standard subroutines directly, you ensure that your program will 
work properly in conjunction with other software, such as DOS or a printer 
driver, that changes one or both of the I/O links. 

For the purposes of this chapter, we shall assume that the I/O links contain 
the addresses of the standard I/O subroutines— GOUT 1 and KEYIN if the 
80-column firmware is off, and BASICOUT and BASICIN if it is on. 



Standard Output Features 



The standard output routine is named GOUT, pronounced C-out, which 
stands for character out. COUT normally calls COUT1, which sends one 
character to the display, advances the cursor position, and scrolls the 
display when necessary. COUT1 restricts its use of the display to an active 
area called the text window, described below. 



COUT Output Subroutine 

Your program makes a subroutine call to COUT at memory location $FDED 
with a character in the accumulator. COUT then passes control via the 
output link CSW to the current output subroutine, normally COUT1 (or 
BASICOUT), which takes the character in the accumulator and writes it 
out. If the accumulator contains an uppercase or lowercase letter, a number, 
or a special character, COUT1 displays it; if the accumulator contains a 
control character, COUT1 either performs one of the special functions 
described below or ignores the character. 

Each time you send a character to COUT1, it displays the character at the 
current cursor position, replacing whatever was there, and then advances 
the cursor position one space to the right, If the cursor position is already at 
the right-hand edge of the window, COUT1 moves it to the left-most position 
on the next line down. If this would move the cursor position past the end of 
the last line in the window, COUT1 scrolls the display up one line and sets 
the cursor position at the left end of the new bottom line. 

The cursor position is controlled by the values in memory locations 36 and 
37 (hexadecimal $24 and $25). These locations are named CH, for cursor 
horizontal, and CV, for cursor vertical, COUT1 does not display a cursor, but 
the input routines described below do, and they use this cursor position. If 
some other routine displays a cursor, it will not necessarily put it in the 
cursor position used by COUT1. 



Standard Output Features 



b) 



Control Characters With COUT1 and BASICOUT 

C0UT1 and BASICOUT do not display control characters. Instead, the 
control characters listed in Tables 3-3a and 3-3b are used to initiate some 
action by the firmware. Other control characters are ignored. Most of the 
functions listed here can also be invoked from the keyboard, either by 
typing the control character listed or by using the appropriate escape code, 
as described in the section "Escape Codes With KEYIN" later in this 
chapter. The stop-list function, described separately, can only be invoked 
from the keyboard. 



Table 3-3a. 


Control Characters Wit 


Control 


ASCII 


Apple lie 


Character 


Name 


Name 


Control-G 


BEL 


bell 


Control-H 


BS 


backspace 


Control-J 


LF 


line feed 


Control-M 


CB 


return 



Action Taken by COUT1 

Produces a 1000 Hz tone for 0.1 second. 

Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 

Moves cursor position down to next line in 
window; scrolls if needed. 

Moves cursor position to left end of next 
line in window; scrolls if needed. 



Table S-3b. Control Characters With 80-Column Firmware On 



Control 


ASCII 


Apple He 


Character 


Name 


Name 


Control-G 


BEL 


bell 


Control-H 


BS 


backspace 


Control-J 


LF 


line feed 


Control-Kt 


VT 


clear EOS 


Control-Lf 


FF 


home 

and clear 



Action Taken by BASICOUT 

Produces a 1000 Hz tone for 0.1 second. 

Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 

Moves cursor position down to next line in 
window; scrolls if needed. 

Clears from cursor position to the end of 
the screen. 

Moves cursor position to upper-left corner 
of window and clears window. 
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Table 3-3 b— Continued. Control Characters With 80-Column Firmware On 



Control 
Character 


ASCII 
Name 


Apple He 
Name 


Control- M 


CB 


return 


Control-Nt 


SO 


normal 


Control-Ot 


SI 


inverse 


Control-Qt 


DC1 


40-column 


Control-Rt 


DC2 


80-column 


Control-S* 


DC3 


stop-list 


Control-U t 


NAK 


quit 


Control-V f 


SYN 


scroll 


Control-Wt 


ETB 


scroll-up 


Control-X 


CAN 


disable 
MouseText 


Control-Y f 


EM 


home 


Control-Z t 


SUB 


clear line 


Control-[ 


ESC 


enable 
MouseText 


Control- \t 


FS 


forward 
space 



Control-]t 



Control- 



GS clear EOL 



US 



up 



Action Taken by BASICOUT 

Moves cursor position to left end of next 
line in window; scrolls if needed. 

Sets display format normal. 

Sets display format inverse. 

Sets display to 40-column. 

Sets display to 80-column. 

Stops listing characters on the display 
until another key is pressed. 

Deactivates 80-column video firmware, 

Scrolls the display down one line, leaving 
the cursor in the current position. 

Scrolls the display up one line, leaving the 
cursor in the current position. 

Disable MouseText character display; use 
inverse uppercase. 

Moves cursor position to upper-left corner 
of window (but doesn't clear), 

Clears the line the cursor position is on. 

Map inverse uppercase characters to 
MouseText characters. 

Moves cursor position one space to the 
right; from right edge of window, moves it 
to left end of line below. 

Clears from the current cursor position to 
the end of the line (that is, to the right 
edge of the window). 

Moves cursor up a line, no scroll 



* Only works from the keyboard. 
t Doesn't work from the keyboard. 
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The Stop-List Feature 

When you are using any program that displays text via C0UT1 (or 
BASICOUT), you can make it stop updating the display by holding down 
i control I and pressing [§]. Whenever COUT1 gets a carriage return from 
the program, it checks to see if you have pressed | control f fsl. If you 
have, COUT1 stops and waits for you to press another key. When you want 
COUT1 to resume, press another key; COUT1 will send the carriage return it 
got earlier to the display, then continue normally. The character code of the 
key you pressed to resume displaying is ignored unless you pressed 
I control h fc]. COUT1 passes Control-C back to the program; if it is a 
BASIC program, this enables you to terminate the program while in stop-list 
mode. 



The Text Window 



Original tie 



After starting up the computer or after a reset, the firmware uses the entire 
display. However, you can restrict video activity to any rectangular portion 
of the display you wish. The active portion of the display is called the 
text window. COUT1 or BASICOUT puts characters into the window only; 
when it reaches the end of the last line in the window, it scrolls only the 
contents of the window. 

You can set the top, bottom, left side, and width of the text window by 
storing the appropriate values into four locations in memory. This enables 
your programs to control the placement of text in the display and to protect 
other portions of the screen from being written over by new text. 

Memory location 32 (hexadecimal $20) contains the number of the leftmost 
column in the text window. This number is normally 0, the number of the 
leftmost column in the display. In a 40-column display, the maximum value 
for this number is 39 (hexadecimal $27); in an 80-column display, the 
maximum value is 79 (hexadecimal $4F). 

Memory location 33 (hexadecimal $21) holds the width of the text window. 
For a 40-column display, it is normally 40 (hexadecimal $28); for an 
80-column display, it is normally 80 (hexadecimal $50). 

COUT1 truncates the column width to an even value on the original 
Apple He. 
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▲Warning 



▲Warning 



On an original Apple lie, be careful not to let the sum of the window 
width and the leftmost position in the window exceed the width of the 
display you are using (40 or 80). If this happens, it is possible for COUT1 
to put characters into memory locations outside the display page, possibly 
into your current program or data space. 

Memory location 34 (hexadecimal $22) contains the number of the top line 
of the text window. This is normally 0, the topmost line in the display. Its 
maximum value is 23 (hexadecimal $17). 

Memory location 35 (hexadecimal $23) contains the number of the bottom 
line of the screen, plus 1. It is normally 24 (hexadecimal $18) for the bottom 
line of the display. Its minimum value is 1. 

After you have changed the text window boundaries, nothing is affected 
until you send a character to the screen. 

Any time you change the boundaries of the text window, you should 
make sure that the current cursor position (stored at CH and CV) is inside 
the new window. If it is outside, it is possible for COUT1 to put characters 
into memory locations outside the display page, possibly destroying 
programs or data. 

Table 3-4 summarizes the memory locations and the possible values for the 
window parameters. 



Table 3-4. Text Window Memory Locations 



Window 
Parameter 


Location 
Dec Hex 


Minimuni 
Value 
Dec Hex 


Normal Values 
40 col. 80 col. 
Dec Hex Dec Hex 


Maximum Values 

40 col. 80 col. 

Dec Hex Dec Hex 


Left Edge 


■li 


$20 


00 


$00 


00 


$00 


OK: 


$00 


39 


$27 


79 


S4F 


Width 


m 


$21 


00 


$00 


40 


$28 


90 


$50 


40 


$28 


80 


$50 


Top Edge 


34 


$22 


00 


$00 


00 


$00 


00 


$00 


20 


$17 


28 


$17 


Bottom Edge 


05 


$23 


01 


$01 


24 


$18 


24 


$18 


24 


$18 


24 


$18 
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Inverse and Flashing Text 

Subroutine C0UT1 can display text in normal format, inverse format, or, 
with some restrictions, flashing format. The display format for any 
character in the display depends on two things: the character set being used 
at the moment, and the setting of the two high-order bits of the character's 
byte in the display memory. 

As it sends your text characters to the display, COUT1 sets the high-order 
bits according to the value stored at memory location 50 (hexadecimal $32). 
If that value is 255 (hexadecimal $FF), COUT1 sets the characters to 
display in normal format; if the value is 63 (hexadecimal $3F), COUT1 sets 
the characters to inverse format. If the value is 127 (hexadecimal S7F) and 
if you have selected the primary character set, the characters will be 
displayed in flashing format. Note that flashing format is not available in 
the alternate character set. 



Table 3-5. Text Format Control Values 



Note: These mask values apply only to the primary character set (see text). 

Display Format 

Normal, uppercase, and lowercase 

Flashing, uppercase, and symbols 

Inverse, uppercase, and lowercase 



Mask Value 


[»ec 


Hex 


255 


$FF 


127 


$7F 


63 


$3F 



Important! 



To control the display format of the characters, routine COUT1 uses the 
value at location 50 as a logical mask to force the setting of the two 
high-order bits of each character byte it puts into the display page. It does 
this by performing the logical AND function on the data byte and the mask 
byte. The result byte contains a in any bit that was in the mask. 
BASICOUT, used when the 80-column firmware is active, changes only the 
high-order bit of the data. 

If the 80-column firmware is inactive and you store a mask value at 
location 50 with zeros in its low-order bits, COUT1 will mask out those 
bits in your text. As a result, some characters will be transformed into 
other characters. You should set the mask to the values given in Table 3-5 
only. 
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Switching between character sets is 
described in the section "Display Mode 
Switching" in Chapter 2. 



Original lie 



If you set the mask value at location 50 to 127 (hexadecimal $7F), the 
high-order bit of each result byte will be 0, and the characters will be 
displayed either as lowercase or as flashing, depending on which character 
set you have selected. Refer to the tables of display character sets in 
Chapter 2, In the primary character set, the next-highest bit, bit 6, selects 
flashing format with uppercase characters, With the primary character set 
you can display lowercase characters in normal format and uppercase 
characters in normal, inverse, and flashing formats. In the alternate 
character set, bit 6 selects lowercase or special characters. With the 
alternate character set you can display uppercase and lowercase characters 
in normal and inverse formats. 

On the original Apple He, the MouseText characters are replaced by 
uppercase inverse characters. 



For more information on GETLN, see the 
section "Editing With GETLN," later in this 
chapter. 



Standard Input Features 



The Apple lie's firmware includes two different subroutines for reading 
from the keyboard. One subroutine is named RDKEY, which stands for 
read key. It calls the standard character input subroutine KEY1N (or 
BASICIN when the 80-column firmware is active) which accepts one 
character at a time from the keyboard. 

The other subroutine is named GETLN, which stands for get line. By 
making repeated calls to RDKEY, GETLN accepts a sequence of characters 
terminated with a carriage return. GETLN also provides on-screen editing 
features. 



RDKEY Input Subroutine 

A program gets a character from the keyboard by making a subroutine call 
to RDKEY at memory location $FD0C, RDKEY sets the character at the 
cursor position to flash, then passes control via the input link KSW to the 
current input subroutine, which is normally KEYIN or BASICIN. 

RDKEY displays a cursor at the current cursor position, which is 
immediately to the right of whatever character you last sent to the display 
(normally by using the COUT routine, described earlier). The cursor 
displayed by RDKEY is a flashing version of whatever character happens to 
be at that position on the screen. It is usually a space, so the cursor appears 
as a blinking rectangle. 
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Escape mode is described in the next 
section, "Escape Codes." 



KEYIN Input Subroutine 

KEY1N is the standard input subroutine when the 80-column firmware is 
inactive; BASICIN is used when the 80-column firmware is active. When 
called, the subroutine waits until the user presses a key, then returns with 
the key code in the accumulator. 

If the 80-column firmware is inactive, KEYIN displays a cursor by 
alternately storing a checkerboard block in the cursor location, then storing 
the original character, then the checkerboard again. If the firmware is 
active, BASICIN displays a steady inverse space (rectangle), unless you are 
in escape mode, when it displays a plus sign (+) in inverse format. 

KEYIN also generates a random number. While it is waiting for the user to 
press a key, KEYIN repeatedly increments the 16-bit number in memory 
locations 78 and 79 (hexadecimal $4E and $4F). This number keeps 
increasing from to 65535, then starts over again at 0. The value of this 
number changes so rapidly that there is no way to predict what it will be 
after a key is pressed, A program that reads from the keyboard can use this 
value as a random number or as a seed for a random number routine. 

When the user presses a key, KEYIN accepts the character, stops displaying 
the cursor, and returns to the calling program with the character in the 
accumulator. 



Escape Codes 

KEYIN has special functions that you invoke by typing escape codes on the 
keyboard. An escape code is obtained by pressing flscT releasing it, and 
then pressing some other key. See Table 3-6; the notation in the table means 
press | esc | , release it, then press the key that follows. 

Table 3-6 includes three sets of cursor-control keys, The first set consists of 
I esc I followed by A, B, C, or D. The letter keys can be either uppercase or 
lowercase. These keys are the standard cursor-motion keys on older 
Apple II models; they are present on the Apple He primarily for 
compatibility with programs written for old machines. 

Cursor Motion in Escape Mode 

The second and third set of cursor-control keys are listed together because 
they activate escape mode. In escape mode, you can keep using the 
cursor-motion keys without pressing |~esc1 again. This enables you to 
perform repeated cursor moves by holding down the appropriate key. 
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When the 80-column firmware is active, you can tell when BASICIN is in 
escape mode; it displays a plus sign in inverse format as the cursor, You 
leave escape mode by typing any key other than a cursor-motion key. 

The escape codes with the directional arrow keys are the standard 
cursor-motion keys on the Apple He. The escape codes with the I. J, K, and 
M keys are the standard cursor-motion keys on the Apple II Plus, and are 
present on the Apple He for compatibility with the Apple II Plus. On the 
Apple He, the escape codes with the I, J, K, and M keys function with either 
uppercase or lowercase letters. 



Table 3-6. Escape Codes 



Escape Code 

fEsci r@i 
nscifAiorrri 

[esc] QT) or fj] 
[esc] [c] or GO 

rEscirpiorrdi 
rEsci priornn 
nscimorm 
fisci rnorrnor rEsci rn 

[He] or Q] or (Jsc] Q 
[isc] (T| or fj] or [|sc] E] 

rEscir^ orrmior rEsc~) [T 

"isciin 



ESC | |~B~| 

| ESC ] [c ontrol Ifo] 

TSCirCONTROLH T] 

: lsc 1 [control H "q] 



Function 

Clears window and homes cursor (places it in upper-left corner of screen), then exits from 
escape mode. 

Moves cursor right one line; exits from escape mode. 

Moves cursor left one line; exits from escape mode. 

Moves cursor down one line; exits from escape mode. 

Moves cursor up one line; exits from escape mode. 

Clears to end of line; exits from escape mode. 

Clears to bottom of window; exits from escape mode. 

Moves the cursor up one line; remains in escape mode. See text. 

Moves the cursor left one space; remains in escape mode. See text. 

Moves the cursor right one space; remains in escape mode. See text. 

Moves the cursor down one line; remains in escape mode. See text. 

If 80-column firmware is active, switches to 40-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 

If 80-column firmware is active, switches to 80-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 

Disables control characters; only carriage return, line feed, BELL, and backspace have an 
effect when printed. 

Reactivates control characters. 

If 80-column firmware is active, deactivates 80-column firmware; sets links to KEY1N and 
COUT1; restores normal window size; exits from escape mode. 



■ 
■ 



Standard Input Features 



GETLN Input Subroutine 

Programs often need strings of characters as input. While it is possible to 
call RDKEY repeatedly to get several characters from the keyboard, there is 
a more powerful subroutine you can use. This routine is named GETLN, 
which stands forget, line, and starts at location $FD6A. Using repeated 
calls to RDKEY, GETLN accepts characters from the standard input 
subroutine— usually KEYIN— and puts them into the input buffer located 
in the memory page from $200 to $2FF. GETLN also provides the user with 
on-screen editing and control features, described in the next section 
"Editing With GETLN." 

The first thing GETLN does when you call it is display a prompting 
character, called simply a prompt. The prompt indicates to the user that 
the program is waiting for input. Different programs use different prompt 
characters, helping to remind the user which program is requesting the 
input, For example, an INPUT statement in a BASIC program displays a 
question mark (?) as a prompt. The prompt characters used by the 
different programs on the Apple He are shown in Table 3-7. 

GETLN uses the character stored at memory location 51 (hexadecimal $33) 
as the prompt character. In an assembly-language program, you can change 
the prompt to any character you wish. In BASIC, changing the prompt 
character has no effect, because both BASIC interpreters and the Monitor 
restore it each time they request input from the user. 



Table 3-7. Prompt Characters 



Prompt Character 

? 

i 

> 



Program Requesting Input 

User's BASIC program (INPUT statement) 
Applesoft BASIC (Appendix D) 
Integer BASIC (Appendix D) 
Firmware Monitor (Chapter 5) 



As you type the character string, GETLN sends each character to the 
standard output routine— normally COUT1— which displays it at the 
previous cursor position and puts the cursor at the next available position 
on the display, usually immediately to the right. As the cursor travels across 
the display, it indicates the position where the next character will be 
displayed. 
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Important! 



GETLN stores the characters in its buffer, starting at memory location $200 
and using the X register to index the buffer. GETLN continues to accept and 
display characters until you press 1 return | ; then it clears the remainder of 
the line the cursor is on, stores the carriage-return code in the buffer, sends 
the carriage-return code to the display, and returns to the calling program. 

The maximum line-length that GETLN can handle is 255 characters. If the 
user types more than this, GETLN sends a backslash ( \ ) and a carriage 
return to the display, cancels the line it has accepted so far, and starts over. 
To warn the user that the line is getting full, GETLN sounds a bell (tone) at 
every keypress after the 248th. 

In the Apple II and the Apple II Plus, the GETLN routine converts all 
input to uppercase, GETLN in the Apple He does not do this, even in 
Apple II mode. To get uppercase input for BASIC, use I caps lock! 



Editing With GETLN 

Subroutine GETLN provides the standard on-screen editing features used 
by the BASIC interpreters and the Monitor. For an introduction to editing 
with these features, refer to the Applesoft Tutorial. Any program that uses 
GETLN for reading the keyboard has these features. 

Cancel Line 



Any time you are typing a line, pressing [ control H ~x1 causes GETLN to 
cancel the line. GETLN displays a backslash ( \ ) and issues a carriage 
return, then displays the prompt and waits for you to type a new line. 
GETLN takes the same action when you type more than 255 characters, as 
described earlier. 



Backspace 

When you press (*], GETLN moves its buffer pointer back one space, 
effectively deleting the last character in its buffer. It also sends a backspace 
character to routine COUT, which moves the display position and the cursor 
back one space, If you type another character now, it will replace the 
character you backspaced over, both on the display and in the line buffer, 
Each time you press Q it moves the cursor left and deletes another 
character, until you reach the beginning of the line. If you then press Q 
one more time, you have cancelled the line, and GETLN issues a carriage 
return and displays the prompt. 
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Retype 

pi has a function complementary to the backspace function. When you 
press p] ( GETLN picks up the character at the display position just as if it 
had been typed on the keyboard. You can use this procedure to pick up 
characters that you have just deleted by backspacing across them. You can 
use the backspace and retype functions with the cursor-motion functions to 
edit data on the display. (See the earlier section "Cursor Motion in Escape 
Mode.") 



Monitor Firmware Support 



Table 3-8 summarizes the addresses and functions of the video display 
support routines the Monitor provides. These routines are described in the 
subsections that follow, 



Table 3-8. 


Video Firmware Routines 


Location 


Name 


Description 


$0307 


BASICOUT 


Displays a character on the screen when 
80-column firmware is active. 


SFC9C 


CLREOL 


Clears to end of line from current cursor 
position. 


$FC9E 


CLEOLZ 


Clears to end of line using contents of Y register 
as cursor position. 


$FC42 


CLREOP 


Clears to bottom of window. 


$F832 


CLRSCR 


Clears the low-resolution screen. 


$F836 


CLRTOP 


Clears top 40 lines of low-resolution screen. 


$FDED 


GOUT 


Calls output routine whose address is stored in 
CSW (normally COUT1, Chapter 3). 


$FDF0 


COUT1 


Displays a character on the screen (Chapter 3). 


$FD8E 


CROUT 


Generates a carriage return character. 


IFD8B 


GROUT 1 


Clears to end of line, then generates a carriage 



$F819 



HLINE 



return character. 

Draws a horizontal line of blocks. 



-:: 
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Table 3-8 — Continued. Video Firmware Routines 



Location 


Name 


Description 


SFC58 


HOME 


Clears the window and puts cursor in upper-left 
corner of window. 


JF800 


PLOT 


Plots a single low-resolution block on the screen. 


$F94A 


PRBL2 


Sends 1 to 256 blank spaces to the output device 
whose address is in GSW. 


$FDDA 


PRBYTE 


Prints a hexadecimal byte. 


$FF2D 


PRERR 


Sends ERR and Control-G to the output device 
whose output routine address is in GSW. 


$FDE3 


PRHEX 


Prints 4 bits as a hexadecimal number. 


$F941 


PRNTAX 


Prints contents of A and X in hexadecimal. 


$F871 


SCRN 


Reads color value of a low-resolution block on 
the screen. 


$F864 


SETCOL 


Sets the color for plotting in low-resolution. 


$FC24 


VTABZ 


Sets cursor vertical position. (Setting CV at 



$F82£ 



VL1NE 



location $25 does not change vertical positon 
until a carriage return.) 

Draws a vertical line of low-resolution blocks. 



BASICOUT, $C307 

BASICOUT is essentially the same as COUT1— BASICOUT is used instead 
of COUT1 when the 80-column firmware is active. BASICOUT displays the 
character in the accumulator on the display screen at the current cursor 
position and advances the cursor. It places the character using the setting of 
the inverse mask (location $32). BASICOUT handles control characters; see 
Table 3-3b. When it returns control to the calling program, all registers are 
intact. 



■ 
I 



CLREOL, $FC9C 

CLREOL clears a text line from the cursor position to the right edge of the 
window. This routine destroys the contents of A and Y. 
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CLEOLZ, $FC9 E 

CLEOLZ clears a text line to the right edge of the window, starting at the 
location given by base address BASL, which is indexed by the contents of 
the Y register, This routine destroys the contents of A and Y. 



CLREOP, $FC42 

CLREOP clears the text window from the cursor position to the bottom of 
the window. This routine destroys the contents of A and Y. 



CLRSCR, $F832 

CLRSCE clears the low-resolution graphics display to black, If you call this 
routine while the video display is in text mode, it fills the screen with 
inverse-mode at-sign (@) characters. This routine destroys the contents 
of A and Y. 



CLRTOP, $F836 

CLRTOP is the same as CLRSCR, except that it clears only the top 40 rows 
of the low-resolution display. 



COUT, SFDED 

COUT calls the current character output subroutine. (See the section 
"COUT Output Subroutine" earlier in this chapter,) The character to be sent 
to the output device should be in the accumulator, COUT calls the 
subroutine whose address is stored in CS W (locations $36 and $37), which 
is usually the standard character output subroutine COUT1 (or BASICOUT). 



See the section "Control Characters With 
COUT1 and BASICOUT," earlier in this 
chapter for more information on COUTL 



COUT1, $FDFO 

COUT1 displays the character in the accumulator on the display screen at 
the current cursor position and advances the cursor. It places the character 
using the setting of the inverse mask (location $32). It handles these control 
characters: carriage return, line feed, backspace, and bell. When it returns 
control to the calling program, all registers are intact. 



CROUT, $FD8E 

CROUT sends a carriage return to the current output device. 
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CR0UT1, $F D8B 

CR0UT1 clears the screen from the current cursor position to the edge of 
the text window, then calls CROUT, 



HLINE, $F819 

HLINE draws a horizontal line of blocks of the color set by SETCOL on the 
low-resolution graphics display. Call HLINE with the vertical coordinate of 
the line in the accumulator, the leftmost horizontal coordinate in the 
Y register, and the rightmost horizontal coordinate in location $2C. HLINE 
returns with A and Y scrambled and X intact. 

HOME, SFC58 

HOME clears the display and puts the cursor in the upper-left corner of the 
screen, 

PLOT, $F800 

PLOT puts a single block of the color value set by SETCOL on the 
low-resolution display screen. Call PLOT with the vertical coordinate of the 
line in the accumulator, and its horizontal position in the Y register, PLOT 
returns with the accumulator scrambled, but X and Y intact. 

PRBL2, $F94A 

PRBL2 sends from 1 to 256 blanks to the standard output device. Upon 
entry, the X register should contain the number of blanks to send. If 
X = $00, then PRBLANK will send 256 blanks. 

PRBYTE, $FDDA 

PRBYTE sends the contents of the accumulator in hexadecimal to the 
current output device. The contents of the accumulator are scrambled. 

PRERR, $FF2D 

PRERR sends the word err, followed by a bell character, to the standard 
output device. On return, the accumulator is scrambled. 
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PRHEX, $FDE3 

PRHEX prints the lower nibble of the byte in the accumulator as a single 
hexadecimal digit, On return, the contents of the accumulator are 
scrambled. 



PRNTAX, $F941 

PRTAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte printed, and 
the X register contains the second. On return, the contents of the 
accumulator are scrambled. 



SCRN, $F871 

SCRN returns the color value of a single block on the low-resolution display. 
Call it with the vertical position of the block in the accumulator and the 
horizontal position in the Y register. The block's color is returned in the 
accumulator. No other registers are changed. 

SETCOL, SF864 

SETCOL sets the color used for plotting in low-resolution graphics to the 
value passed in the acumulator. The colors and their values are listed in 
Table 2-6. 

VTABZ, $FC24 

VTABZ sets the cursor vertical position. Unlike setting the position at 
location $25, change of cursor position doesn't wait until a carriage return 
character has been sent. 

VLINE, $F828 

VLINE draws a vertical line of blocks of the color set by SETCOL on the 
low-resolution display. Call VLINE with the horizontal coordinate of the line 
in the Y register, the top vertical coordinate in the accumulator, and the 
bottom vertical coordinate in location $2D. VLINE returns with the 
accumulator scrambled. 
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I/O Firmware Support 



Apple He video firmware conforms to the I/O firmware protocol of Apple II 
Pascal 1.1. However, it does not support windows other than the full 
80-by-24 window in 80-column mode, and the full 40-by-24 window in 
40-column mode. The video protocol table is shown in Table 3-9. 



Table 3-9. Slot 3 Firmware Protocol Table 



Address Value Description 

$C30B $01 Generic signature byte of firmware cards 

$C30C $88 80-column card device signature 

IC30D $ii $C3ii is entry point of initialization routine (PINIT). 

$C30E $rr $C3rr is entry point of read routine (PREAD). 

$C30F $ww $C3ww is entry point of write routine (FWRITE). 

$C310 $ss $C3ss is entry point of the status routine (PSTATUS). 



PINIT, $C30D 

PINIT does the following; 

d Sets a full 80-column window. 
d Sets80STORE($C001). 

□ Sets80COL($C00D), 

n Switches on ALTCHAR ($C00F). 

d Clears the screen; places cursor in upper-left corner. 

□ Displays the cursor. 

PREAD, $C30E 

PREAD reads a character from the keyboard and places it in the 
accumulator with the high bit cleared. It also puts a zero in the X register to 
indicate IORESULT = GOOD. 
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PW RITE, $C30 F 

PWRITE should be called after placing a character in the accumulator with 
its high bit cleared. PWRITE does the following; 

a Turns the cursor off. 

a If the character in the accumulator is not a control character, turns the 
high bit on for normal display or off for inverse display, displays it at the 
current cursor position, and advances the cursor; if at the end of a line, 
does carriage return but not line feed. (See Table 3-10 for control 
character functions.) 

When PWRITE has completed this, it 

□ turns the cursor back on (if it was not intentionally turned off) 
a puts a zero in the X register (IORESULT = GOOD) and returns to the 
calling program. 

Table 3-10. Pascal Video Control Functions 



Control- 


Hex 


Eore 


$05 


Forf 


$06 


Gorg 


$07 


Horn 


$08 


Jorj 


$0A 


Kork 


$0B 


Lorl 


$0C 


Morm 


$0D 


Norn 


$0E 



Function Performed 

Turns cursor on (enables cursor display). 

Turns cursor off (disables cursor display). 

Sounds bell (beeps). 

Moves cursor left one column. If cursor was at beginning of 
line, moves it to end of previous line. 

Moves cursor down one row; scrolls if needed. 

Clears to end of screen. 

Clears screen; moves cursor to upper-left of screen. 

Moves cursor to column 0. 

Displays subsequent characters in normal video. (Characters 
already on display are unaffected.) 
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Table 3-10 — Continued. Pascal Video Control Functions 

Control- Hex Function Performed 

or o $0F Displays subsequent characters in inverse video. 
(Characters already on display are unaffected.) 

V or v $16 Scrolls screen up one line; clears bottom line. 

Worw $17 Scrolls screen down one line; clears top line. 

Yory $19 Moves cursor to upper-left (home) position on screen, 

Zorz $1A Clears entire line that cursor is on. 

or \ $1C Moves cursor right one column; if at end of line, does 

Control-M, 

} or ] $ 1 D Clears to end of the line the cursor is on, including current 

cursor position; does not move cursor. 

" or 6 $1E GOTOxy: initiates a GOTOxy sequence; interprets the next 
two characters as x+32 and y+32, respectively. 

_ $ 1 F If not at top of screen, moves cursor up one line. 



PSTATUS, $C31Q 

A program that calls PSTATUS must first put a request code in the 
accumulator: either a 0, meaning "Ready for output?" or a 1, meaning "Is 
there any input?" PSTATUS returns with the reply in the cany bit: (No) 
or 1 (Yes). 

PSTATUS returns with a in the X register (IORESULT = GOOD), unless 
the request was not or 1; then PSTATUS returns with a 3 in the X register 
(IORESULT - ILLEGAL OPERATION). 
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Original He 



For details of the built-in I/O features, refer 
to the descriptions in Chapters 2 and 3. 

For information about I/O operations with 
peripheral cards, refer to Chapter 6. 



The Apple lie's microprocessor can address 65,536 (64K) memory locations. 
All of the programmable storage (RAM and ROM) and input and output 
devices are allocated locations in this 64K address space. Some functions 
share the same addresses— but not at the same time. 

For information about these shared address spaces, see the section 
"Bank-Switched Memory" in this chapter and the sections "Other Uses of 
I/O Memory Space" and "Expansion ROM Space" in Chapter 6. 

The original version of the Apple He, as well as the Apple II Plus and 
Apple II, use the 6502 microprocessor. The 6502 lacks ten instructions 
and two addressing modes found on the 65C02 of the enhanced Apple He, 
but is otherwise functionally similar. For more information about the 
differences between the two processors, see Appendix A. In this manual, 
unless otherwise stated, the two processors are effectively the same. 

All input and output in the Apple lie is memory mapped. This means that 
all devices connected to the Apple He appear to be memory locations to the 
computer. In this chapter, the I/O memory spaces are described simply as 
blocks of memory. 

Programmers often refer to the Apple He's memory in 256-byte blocks called 
pages. One reason for this is that a one-byte address counter or index 
register can specify one of 256 different locations. Thus, page consists of 
memory locations from to 255 (hexadecimal $00 to IFF), inclusive. Page 1 
consists of locations 256 to 511 (hexadecimal $0100 to $01FF); note that the 
page number is the high-order part of the hexadecimal address. Don't 
confuse this kind of page with the display buffers in the Apple He, which 
are sometimes referred to as Page 1 and Page 2. 



Main Memory Map 

The map of the main memory address space in Figure 4-1 shows the 
functions of the major areas of memory. For more details on the I/O space 
from 48K to 52K ($C000 through $CFFF), refer to Chapter 2 and Chapter 6; 
the bank-switched memory in the memory space from 52K to 64K (SD0O0 
through $FFFF) is described in the section "Bank-Switched Memory" later 
in this chapter. 
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Figure 4-1. System Memory Map 
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RAM Memory Allocation 



As Figure 4-1 shows, the major portion of the Apple lie's memory space is 
allocated to programmable storage (RAM). Figure 4-2 shows the areas 
allocated to RAM. The main RAM memory extends from location to 
location 49151 (hex $BFFF), and occupies pages through 191 
(hexadecimal $BF). There is also RAM storage in the bank-switched space 
from 53248 to 65535 (hexadecimal JD000 to $FFFF), described in the 
section "Bank-Switched Memory" later in this chapter, and auxiliary RAM, 
described in the section "Auxiliary Memory and Firmware" later in this 
chapter, 



Figure 4-$. RAM Allocation Map 
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Important! 



Reserved Memory Pages 

Most of the Apple He's RAM is available for storing your programs and data. 
However, a few RAM pages are reserved for the use of the Monitor firmware 
and the BASIC interpreters. The reserved pages are described in the 
following sections. 

The system does not prevent your using these pages, but if you do use 
them, you must be careful not to disturb the system data they contain, or 
you will cause the system to malfunction. 



Page Zero 

Several of the 65C02 microprocessor's addressing modes require the use of 
addresses in page zero, also called zero page. The Monitor, the BASIC 
interpreters, DOS 3.3, and ProDOS all make extensive use of page zero. 

To use indirect addressing in your assembly-language programs, you must 
store base addresses in page zero. At the same time, you must avoid 
interfering with the other programs that use page zero— the Monitor, the 
BASIC interpreters, and the disk operating systems. One way to avoid 
conflicts is to use only those page-zero locations not already used by other 
programs. Tables 4-1 through 4-5 show the locations in page zero used by 
the Monitor, Applesoft BASIC, Integer BASIC, DOS 3.3, and ProDOS. 

As you can see from the tables, page zero is pretty well used up, except for a 
few bytes here and there. It's hard to find more than one or two bytes that 
aren't used by either BASIC, ProDOS, the Monitor, or DOS. Rather than 
trying to squeeze your data into an unused corner, you may prefer a safer 
alternative: save the contents of part, of page zero, use that part, then 
restore the previous contents before you pass control to another program. 

The 65C02 Stack 



The 65C02 microprocessor uses page 1 as the stack— the place where 
subroutine return addresses are stored, in last-in, first-out sequence. Many 
programs also use the stack for temporary storage of the registers (via push 
and pull operations). You can do the same, but you should use it sparingly. 
The stack pointer is eight, bits long, so the stack can hold only 256 bytes of 
information at a time. When you store the 257th byte in the stack, the stack 
pointer repeats itself, or wraps around, so that the new byte replaces the 
first byte stored, which is now lost. This writing over old data is called stack 
overflow, and when it happens, the program continues to run normally until 
the lost information is needed, whereupon the program terminates 
catastrophically. 



RAM Memory Allocation 



75 



The Input Buffer 

The GETLN input routine, which is used by the Monitor and the BASIC 
interpreters, uses page 2 as its keyboard-input buffer. The size of this buffer 
sets the maximum size of input strings, (Note: Applesoft uses only the first 
237 bytes, although it permits you to type in 256 characters.) If you know 
that you won't be typing any long input strings, you can store temporary 
data at the upper end of page 2. 



For more information about links, see the 
section "Changing the Standard I/O Links" 
in Chapter 6. 



Link-Address Storage 

The Monitor, ProDOS, and DOS 3.3 all use the upper part of page 3 for link 
addresses or vectors. 

BASIC programs sometimes need short machine-language routines. These 
routines are usually stored in the lower part of page 3. 



See Chapter 6 for information on the 
memory locations that are reserved for 
peripheral cards. 



For more information about the display 
buffers, see the section "Video Display 
Pages" in Chapter 2. 



The Display Buffers 

The primary text and low-resolution-graphics display buffer occupies 
memory pages 4 through 7 (locations 1024 through 2047, hexadecimal $0400 
through $07FF). This entire 1024-byte area is called text Page 1, and it is not 
usable for program and data storage. There are 64 locations in this area that 
are not displayed on the screen; these locations are reserved for use by the 
peripheral cards. 

Text Page 2, the alternate text and low-resolution-graphics display buffer, 
occupies memory pages 8 through 11 (locations 2048 through 3071, 
hexadecimal $0800 through S0BFF). Most programs do not use Page 2 for 
displays, so they can use this area for program or data storage, 

The primary high-resolution-graphics display buffer, called high-resolution 
Page 1, occupies memory pages 32 through 63 (locations 8192 through 
16383, hexadecimal $2000 through $3FFF). If your program doesn't use 
high-resolution graphics, this area is usable for programs or data. 

High-resolution Page 2 occupies memory pages 64 through 95 (locations 
16384 through 24575, hexadecimal $4000 through $5FFF). Most programs 
use this area for program or data storage. 

The primary double-high-resolution-graphics display buffer, called 
double-high-resolution Page 1, occupies memory pages 32 through 63 
(locations 8192 through 16383, hexadecimal $2000 through S3FFF) in both 
main and auxiliary memory. If your program doesn't use high-resolution or 
double-high-resolution graphics, this area of main memory is usable for 
programs or data. 
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Table 4-1. Monitor Zero-Page Use 

High Nibble Low Nibble of Address 

of Address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A SB $C $D SE $F 

$00 
$10 

$20 

$30 

$40 

$50 

$60 
$70 
$80 
$90 
SAO 
$B0 
$C0 
$D0 
$E0 
$F0 

* Byte used in original Apple He ROMs, now free. 



Table 4-2. Applesoft Zero-Page Use 



High Nibble Low Nibble of Address 

of Address $0 $1 52 $3 $4 55 $6 $7 $8 $9 SA IB $C SD SE 5F 



$00 
$10 
$20 
$30 
$40 
$50 
$60 
$70 
$80 
$90 
$A0 
$B0 
$C0 
$D0 
$E0 
$F0 



• • • 
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Table 4-3. Integer BASIC Zero-Page Use 



High Nibble Low Nibble of Address 

of Address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 SA SB $C $D $E 

$00 . 

$10 

$20 
$30 



• • • • 



$50 
$60 



$90 
SAO 
SB0 
$C0 
$D0 
$E0 
$F0 



Table 4-4. DOS 3.3 Zero-Page Use 



High Nibble Low Nibble of Address 

of Address $0 SI $2 $3 $4 So $6 $7 $8 $9 SA SB SC SD $E $F 

$00 

$10 



$30 
$40 






$60 
$70 



$A0 
$B0 
SCO 
$D0 
$E0 
$F0 



• • • • 



"f 
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Table 4-5. ProDOS MLI and Disk-Driver Zero-Page Use 

High Nibble Low Nibble of Address 

Of Address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B $C $D $E $F 

$00 • • 



$50 
$60 
$70 
$80 
$90 
$A0 
$B0 
SCO 
$D0 
$E0 
$F0 



Bank-Switched Memory 



The memory address space from 52K to 64K (hexadecimal $D000 through 
SFFFF) is doubly allocated: it is used for both ROM and RAM. The 12K bytes 
of ROM (read-only memory) in this address space contain the Monitor and 
the Applesoft BASIC interpreter. Alternatively, there are 16K bytes of RAM 
in this space. The RAM is normally used for storing either the Integer 
BASIC interpreter or part of the Pascal Operating System (purchased 
separately). 

You may be wondering why this part of memory has such a split 
personality. Some of the reasons are historical: the Apple He is able to run 
software written for the Apple II and Apple II Plus because it uses this part 
of memory in the same way they do. It is convenient to have the Applesoft 
interpreter in ROM, but the Apple He, like an Apple II with a language card, 
is also able to use that address space for other things when Applesoft is not 
needed. 
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You may also be wondering how 16K bytes of RAM is mapped into only 12K 
bytes of address space. The usual answer is that it's done with mirrors, and 
that isn't a bad analogy: the 4K-byte address space from 52K to 56K 
(hexadecimal $D000 through $DFFF) is used twice. 

Switching different blocks of memory into the same address space is called 
bank switching. There are actually two examples of bank switching going 
on here: first, the entire address space from 52K to 64K ($D000 through 
$FFFF) is switched between ROM and RAM, and second, the address space 
from 52K to 56K ($DO0O to $DFFF) is switched between two different 
blocks of RAM. 



Figure 4-3. Bank-Switched Memory Map 
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Setting Bank Switches 

You switch banks of memory in the same way you switch other functions in 
the Apple He: by using soft switches. Read operations to these soft switches 
do three things: select either RAM or ROM in this memory space; enable or 
inhibit writing to the RAM (write-protect); and select the first or second 
4K-byte bank of RAM in the address space $D000 to $DFFF. 

Do not use these switches without careful planning. Careless switching 
between RAM and ROM is almost certain to have catastrophic effects on 
your program. 
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Table 4-6 shows the addresses of the soft switches for enabling all 
combinations of reading and writing in this memory space, All of the 
hexadecimal values of the addresses are of the form $C08x. Notice that 
several addresses perform the same function: this is because the functions 
are activated by single address bits. For example, any address of the form 
$C08x with a 1 in the low-order bit enables the RAM for writing. Similarly, 
bit 3 of the address selects which 4K block of RAM to use for the address 
space $D000-$DFFF; if bit 3 is 0, the first bank of RAM is used, and if bit 3 
is 1, the second bank is used. 

When RAM is not enabled for reading, the ROM in this address space is 
enabled. Even when RAM is not enabled for reading, it can still be written to 
if it is write-enabled. 

When you turn power on or reset the Apple He, it initializes the bank 
switches for reading the ROM and writing the RAM, using the second bank 
of RAM. Note that this is different from the reset on the Apple II Plus, which 
didn't affect the bank-switched memory (the language card). On the 
Apple He, you can't use the reset vector to return control to a program in 
bank-switched memory, as you could on the Apple II Plus. 

Reset With Integer BASIC: When you are using Integer BASIC on the 
Apple He, reset works correctly, restarting BASIC with your program 
intact. This happens because the reset vector transfers control to DOS, 
and DOS resets the switches for the current version of BASIC. 
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Table 4-6. Bank Select Switches 



Note; R means read the location, W means write anything to the location, R/W 
means read or write, and R7 means read the location and then check bit 7. 

Name Action Hex Function 

R $CG80 Read RAM; no write; use $DOO0 bank 2. 

RR SC081 Read ROM; write RAM; use SDOOO bank 2, 

R $C082 Read ROM; no write; use $DOO0 bank 2. 

RR $C083 Read and write RAM; use $D000 bank 2. 

R $C088 Read RAM; no write; use $DOO0 bank 1. 

RR $0089 Read ROM; write RAM; use $D0OO bank 1. 

R $C08A Read ROM; no write; use SDOOO bank 1 , 

RR $C08B Read and write RAM; use SDOOO bank 1. 

RDBNK2 R7 $C011 Read whether $D000 bank 2 (1) or bank 1 (0). 

RDLCRAM R7 $0012 Reading RAM (1) or ROM (0). 

ALTZP W $0008 Off; use main bank, page and page 1. 

ALTZP W $0009 On: use auxdiary bank, page and page 1. 

RDALTZP R7 $0016 Read whether auxdiary(l) or main (0) bank. 



Reading and Writing to RAM Banks: Note that you can't read one 
RAM bank and write to the other; if you select either RAM bank for 
reading, you get that one for writing as well. 

Reading RAM and ROM: You can't read from ROM in part, of the 
bank-switched memory and read from RAM in the rest: specifically, you 
can't read the Monitor in ROM while reading bank-switched RAM. If you 
want to use the Monitor firmware with a program in bank-switched RAM, 
copy the Monitor from ROM (locations SF800 through SFFCB) into 
bank-switched RAM. You can't do this from Pascal or ProDOS. 
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To see how to use these switches, look at the following section of an 
assembly-language program; 



AD 


83 


C0 


LDA 


$C083 


AD 


83 


C0 


LDA 


JC083 


A9 


D0 




LDA 


#$D0 


85 


01 




STA 


BEGIN 


A9 


FF 




LDA 


**FF 


85 


02 




STA 


END 


20 


97 


C9 


JSR 


RAMTST 


AD 


8B 


C0 


LDA 


$C08B 


20 


97 


C9 


JSR 


RAMTST 


AD 


83 


C0 


LDA 


$C088 


A9 


80 




LDA 


**80 


£S 


10 




INC 


TSTNUM 


20 


S8 


C9 


JSR 


WPTSINIT 


AD 


60 


C0 


LDA 


$C080 


EG 


10 




IMC 


TSTNUM 


A9 


81 




LDA 


#PAT12K 


2B 


58 


C9 


JSR 


WPTSINIT 


AD 


SB 


C0 


LDA 


$C08B 


AD 


8B 


C0 


LDA 


$C08B 


ES 


0E 




INC 


RWMODE 


EG 


11 




INC 


TSTNUM 


A9 


08 




LDA 


#PAT4K 


20 


58 


C9 


JSR 


WPTSINIT 



•SELECT 2ND 4K BANK t, READ/WRITE 

•BY TWQ CONSECUTIVE READS 

•SET UP. . . 

*. . .NEW. . . 

*. . .MAIN-MEMORY. . . 

*. . .POINTERS. . . 

». . .FOR 12K BANK 

•SELECT 1ST 4K BANK 
•USE ABOVE POINTERS 

•SELECT 1ST BANK & WRITE PROTECT 



•SELECT 2ND BANK 4 WRITE PROTECT 



•SELECT 1ST BANK & READ/WRITE 
•BY TWO CONSECUTIVE READS 
•FLAG RAM IN READ/WRITE 



The LDA instruction, which performs a read operation to the specified 
memory location, is used for setting the soft switches. The unusual 
sequence of two consecutive LDA instructions performs the two 
consecutive reads that write-enable this area of RAM; in this case, the data 
that are read are not used. 



Reading Bank Switches 

You can read which language card bank is currently switched in by reading 
the soft switch at $0011. You can find out whether the language card or 
ROM is switched in by reading $C012. The only way that you can find out 
whether the language card RAM is write-enabled or not is by trying to write 
some data to the card's RAM space. 
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▲Warning 



By installing an optional card in the auxiliary slot, you can add more 
memory to the Apple lie. One such card is the Apple He 80-Column Text 
Card, which has IK bytes of additional RAM for expanding the text display 
from 40 columns to 80 columns. 

Another optional card, the Apple lie Extended 80-Column Text Card, has 
64K of additional RAM. A lK-byte area of this memory serves the same 
purpose as the memory on the 80-Column Text Card: expanding the text 
display to 80 columns. The other 63K bytes can be used as auxiliary 
program and data storage. If you use only 40-column displays, the entire 
64K bytes is available for programs and data. 

Do not attempt to use the auxiliary memory from a BASIC program. The 
BASIC interpreter uses several areas in main RAM, including the stack 
and the zero page. If you switch to auxiliary memory in these areas, the 
BASIC interpreter fails and you must reset the system and start over. 

As you can see by studying the memory map in Figure 4-4, the auxiliary 
memory is broken into two large sections and one small one. The largest 
section is switched into the memory address space from 512 to 49151 ($0200 
through $BFFF). This space includes the display buffer pages: as described 
in the section "Text Modes" in Chapter 2, space in auxiliary memory is used 
for one half of the 80-column text display. You can switch to the auxiliary 
memory for this entire memory space, or you can switch just the display 
pages: see the next section, "Memory Mode Switching." 

Soft Switches: If the only reason you are using auxiliary memory is for 
the 80-column display, note that you can store into the display page in 
auxiliary memory by using the 80STORE and PAGE2 soft switches 
described in the section "Display Mode Switching" in Chapter 2. 

The other large section of auxiliary memory is switched into the memory 
address space from 52K to 64K ($D000 through $FFFF). This memory space 
and the switches that control it are described earlier in this chapter in the 
section "Bank-Switched Memory." If you use the auxiliary RAM in this 
space, the soft switches have the same effect on the auxiliary RAM that 
they do on the main RAM; the bank switching is independent of the 
auxiliary-RAM switching. 



H 
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Figure 44. Memory Map With Auxiliary Memory 
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Bank Switches: Note that the soft switches for the bank-switched 
memory, described in the previous section, do not change when you 
switch to auxiliary RAM. In particular, if ROM is enabled in the 
bank-switched memory space before you switch to auxiliary memory, the 
ROM will still be enabled after you switch. Any time you switch the 
bank-switched section of auxiliary memory in and out, you must also 
make sure that the bank switches are set properly. 

When you switch in the auxiliary RAM in the bank-switched space, you also 
switch the first two pages, from to 511 ($0000 through $01FF). This part 
of memory contains page zero, which is used for important data and base 
addresses, and page one, which is the 65C02 stack. The stack and zero page 
are switched this way so that system software running in the 
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bank-switched memory space can maintain its own stack and zero page 
while it manipulates the 48K address space (from $0200 to $BFFF) in either 
main memory or auxiliary memory. 



▲Warning 



Memory Mode Switching 

Switching the 48K section of memory is performed by two soft switches: the 
switch named RAMRD selects main or auxiliary memory for reading, and 
the one named RAM WRT selects main or auxiliary memory for writing. As 
shown in Table 4-7, each switch has a pair of memory locations dedicated to 
it, one to select main memory, and the other to select auxiliary memory. 
Enabling the read and write functions independently makes it possible for a 
program whose instructions are being fetched from one memory space to 
store data into the other memory space. 

Do not use these switches without careful planning. Careless switching 
between main and auxiliary memories is almost certain to have 
catastrophic effects on the operation of the Apple He, For example, if you 
switch to auxiliary memory with no card in the slot, the program that is 
running will stop and you will have to reset the Apple lie and start over. 

Writing to the soft switch at location $C003 turns RAMRD on and enables 
auxiliary memory for reading; writing to location $C002 turns RAMRD off 
and enables main memory for reading. Writing to the soft switch at location 
$C005 turns RAMWRT on and enables the auxiliary memory for writing; 
writing to location $C004 turns RAMWRT off and enables main memory for 
writing. By setting these switches independently, you can use any of the 
four combinations of reading and writing in main or auxiliary memory. 

Auxiliary memory corresponding to text Page 1 and high-resolution graphics 
Page 1 can be used as part of the address space from $0200 to $BFFF by 
using RAMRD and RAMWRT as described above. These areas in auxiliary 
RAM can also be controlled separately by using the switches described in 
the section "Display Mode Switching" in Chapter 2. Those switches are 
named 80STORE, PAGE2, and HIRES. 

As shown in Table 4-7, the 80STORE switch functions as an enabling 
switch: with it on, the PAGE2 switch selects main memory or auxiliary 
memory. With the HIRES switch off, the memory space switched by PAGE2 
is the text Page 1, from $0400 to $07FF; with HIRES on, PAGE2 switches 
both text Page 1 and high-resolution graphics Page 1, from $2000 to S3FFF. 

If you are using both the auxiliary-RAM control switches and the 
auxiliary-display-page control switches, the display-page control switches 
take priority: if 80STORE is off, RAMRD and RAMWRT work for the entire 
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The next section, "Auxiliary -Memory 
Subroutines," describes firmware that you 
can call to help you switch between main 
and auxiliary memory. 



memory space from $0200 to SBFFF, but if 80STORE is on, RAMRD and 
RAMWRT have no effect on the display page. Specifically, if 80STORE is on 
and HIRES is off, PAGE2 controls text Page 1 regardless of the settings of 
RAMRD and RAMWRT. Likewise, if 80STORE and HIRES are both on, 
PAGE2 controls both text Page 1 and high-resolution graphics Page 1, again 
regardless of RAMRD and RAMWRT. 

A single soft switch named ALTZP (for alternate zero page) switches the 
bank-switched memory and the associated stack and zero page area 
between main and auxiliary memory. As shown in Table 4-7, writing to 
location $C009 turns ALTZP on and selects auxiliary-memory stack and 
zero page; writing to the soft switch at location $C008 turns ALTZP off and 
selects main-memory stack and zero page for both reading and writing. 



Table 4-7. Auxiliary-Memory Select Swi tches. 
Name Function 

RAMRD Read auxiliary memory 
Read main memory 
Read RAMRD switch 

RAMWRT Write auxiliary memory 
Write main memory 
Read RAMWRT switch 

80STORE On; access display page 

Off: use RAMRD, RAMWRT 
Read 80STORE switch 

PAGE2 Page-2 on (aux, memory) 
Page 2 off (main memory) 
Read PAGE2 switch 

HIRES On: access high-res. pages 
Off: use RAMRD, RAMWRT 
Read HIRES switch 

ALTZP Auxiliary stack & z.p. 
Main stack & zero page 
Read ALTZP switch 

* When 80STORE is on, the PAGE2 switch selects main or auxiliary display memory. 

t When 80STORE is on, the HIRES switch enables you to use the PAGE2 switch to switch 
between the high-resolution Page-1 area in main memory or auxiliary memory. 





Location 




Notes 


Hex 


Decimal 




$0003 


49155 -] 


6381 


Write 


$C002 


49154 -] 


6382 


Write 


$C013 


49171 -1 


6365 


Read 


$C005 


49157 -1 


6379 


Write 


$C004 


49156 -1 


.6380 


Write 


$C014 


49172 -] 


.6354 


Read 


$C001 


49153 -] 


.6383 


Write 


$CO00 


49152 -] 


.6384 


Write 


$C018 


49176 -: 


[6360 


Read 


$C055 


49237 -: 


16299 


* 


$0054 


49236 -: 


[6300 


* 


SC01C 


49180 -; 


[6356 


Read 


$C057 


49239 -. 


[6297 


t 


SC056 


49238 -: 


[6298 


t 


SC01D 


49181 -: 


[6355 


Read 


$C009 


49161 - 


L6373 


Write 


$C008 


49160 -. 


L6374 


Write 


$C016 


49174 ■ 


16352 


Read 
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When these switches are on, auxiliary 
memory is being used; when they are off, 
main memory is being used. 



There are three more locations associated with the auxiliary-memory 
switches. The high-order bits of the bytes you read at these 'locations tell 
you the settings of the three soft switches described above. The byte you 
read at location $C013 has its high bit set to 1 if RAMRD is on (auxiliary 
memory is read-enabled), or if RAMRD is off (the 48K block of main 
memory is read-enabled). The byte at location $C014 has its high bit set to 1 
if RAMWRT is on (auxiliary memory is write-enabled), or if RAMWRT is 
off (the 48K block of main memory is write-enabled). The byte at location 
SC016 has its high bit set to 1 if ALTZP is on (the bank-switched area, stack, 
and zero page in the auxiliary memory are selected), or if ALTZP is off 
(these areas in main memory are selected). 

Sharing Memory: In order to have enough memory locations for all of 
the soft switches and remain compatible with the Apple II and 
Apple II Plus, the soft switches listed in Table 4-7 share their memory 
locations with the keyboard functions listed in Table 2-2. The 
operations— read or write— shown in Table 4-7 for controlling the 
auxiliary memory are just the ones that are not used for reading the 
keyboard and clearing the strobe. 



Important! 



Auxiliary-Memory Subroutines 

If you want to write assembly-language programs that use auxiliary 
memory but you don't want to manage the auxiliary memory yourself, you 
can use the built-in auxiliary-memory subroutines. These subroutines make 
it possible to use the auxiliary memory without having to manipulate the 
soft switches described in the previous section. 

The subroutines described below make it easier to use auxiliary memory, 
but they do not protect you from errors. You still have to plan your use of 
auxiliary memory to avoid catastrophic effects on your program. 

You use these built-in subroutines the same way you use the I/O 
subroutines described in Chapter 3: by making subroutine calls to their 
starting locations. Those locations are shown in Table 4-8. 



Table 4-8. 48K RAM Transfer Routines 



Name Action Hex Function 

AUXMOVE JSR $C312 Moves data blocks between main and 

auxiliary 48K memory. 

XFER JMP $C314 Transfers program control between main and 

auxiliary 48K memory. 
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Moving Data to Auxiliary Memory 

In your assembly-language programs, you can use the built-in subroutine 
named AUXMOVE to copy blocks of data from main memory to auxiliary 
memory or from auxiliary memory to main memory. Before calling this 
routine, you must put the data addresses into byte pairs in page zero and set 
the carry bit to select the direction of the move— main to auxiliary or 
auxiliary to main. 

▲Warning Don't try to use AUXMOVE to copy data in page zero or page one (the 
65C02 stack) or in the bank-switched memory (SD000-SFFFF). 
AUXMOVE uses page zero all during the copy, so it can't handle moves in 
the memory space switched by ALTZP. 

The pairs of bytes you use for passing addresses to this subroutine are 
called Al, A2, and A4, and they are used for parameter passing by several of 
the Apple He's built-in routines. The addresses of these byte pairs are 
shown in Table 4-9. 



Table 4-9. Parameters for AUXMOVE Routine 



Note: TheX, Y, and A registers are preserved by AUXMOVE. 



Name 


Loci 


Carry 




AIL 


$3C 


A1H 


$3D 


A2L 


$3E 


A2H 


$3F 


A4L 


$42 


A4H 


$43 



Parameter Passed 

1 = Move from main to auxiliary memory 
= Move from auxiliary to main memory 

Source starting address, low-order byte 
Source starting address, high-order byte 

Source ending address, low-order byte 
Source ending address, high-order byte 

Destination starting address, low-order byte 
Destination starting address, high-order byte 



Put the addresses of the first and last bytes of the block of memory you 
want to copy into Al and A2. Put the starting address of the block of 
memory you want to copy the data to into A4. 

The AUXMOVE routine uses the carry bit to select the direction to copy 
the data. To copy data from main memory to auxiliary memory, set the 
carry bit; to copy data from auxiliary memory to main memory, clear the 
carry bit. 
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When you make the subroutine call to AUXMOVE, the subroutine copies the 
block of data as specified by the A byte pairs and the carry bit. When it is 
finished, the accumulator and the X and Y registers are just as they were 
when you called AUXMOVE. 

Transferring Control to Auxiliary Memory 

You can use the built-in routine named XFER to transfer control to and from 
program segments in auxiliary memory. You must set up three parameters 
before using XFER: the address of the routine you are transferring to, the 
direction of the transfer (main to auxiliary or auxiliary to main), and which 
page zero and stack you want to use. 

Table 4-10. Parameters for XFER Routine 

Note: TheX, Y, and A parameters are preserved by XFER. 



Name or 
Location 

Carry 



Overflow 

$03ED 
$03EE 



Parameter Passed 

1 = Transfer from main to auxiliary memory 

= Transfer from auxiliary to main memory 

1 - Use page zero and stack in auxiliary memory 
= Use page zero and stack in main memory 

Program starting address, low-order byte 

Program starting address, high-order byte 



Put the transfer address into the two bytes at locations $03ED and S03EE, 
with the low-order byte first, as usual. The direction of the transfer is 
controlled by the carry bit: set the carry bit to transfer to a program in 
auxiliary memory; clear the carry bit to transfer to a program in main 
memory. Use the overflow bit to select which page zero and stack you want 
to use: clear the overflow bit to use the main memory; set the overflow bit to 
use the auxiliary memory. 

After you have set up the parameters, pass control to the XFER routine by a 
jump instruction, rather than a subroutine call. XFER saves the 
accumulator and the transfer address on the current stack, then sets up the 
soft switches for the parameters you have selected and jumps to the new 
program. 



■ 
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AWarning 



It is the programmer's responsibility to save the current stack pointer at 
$0100 in main memory and the alternate stack pointer at $0101 in 
auxiliary memory before calling XFER and to restore them after regaining 
control. Failure to do so will cause program errors. 
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For information about the I/O links, see the 
section "Changing the Standard I/O Links" 
in Chapter 6. 

For more information about peripheral-card 
ROM, see the section "Peripheral-Card ROM 
Space" in Chapter 6. 



To put the Apple He into a known state when it has just been turned on or 
after a program has malfunctioned, there is a procedure called the reset 
routine. The reset routine is built into the Apple He's firmware, and it is 
initiated any time you turn power on or press | reset | while holding down 
I control i . The reset routine puts the Apple He into its normal operating 
mode and restarts the resident program. 

When you initiate a reset, hardware in the Apple He sets the 
memory-controlling soft switches to normal; main board RAM and ROM are 
enabled, and, if there is an 80-column text card in the auxiliary slot, 
expansion slot 3 is allocated to the built-in 80-column firmware. Auxiliary 
RAM is disabled and the bank-switched memory space is set up to read from 
ROM and write to RAM, using the second bank at $D000. 

The reset routine sets the display-controlling soft switches to display 
40-column text Page 1 using the primary character set, then sets the 
window equal to the full 40-column display, puts the cursor at the bottom of 
the screen, and sets the display format to normal. 

The reset routine sets the keyboard and display as the standard input and 
output devices by loading the standard I/O links. It turns annunciators 
and 1 off and annunciators 2 and 3 on, clears the keyboard strobe, turns off 
any active peripheral-card ROM and outputs a bell (tone). 

The Apple He has three types of reset: power-on reset, also called cold-start 
reset; warm-start reset; and forced cold-start reset. The procedure described 
above is the same for any type of reset. What happens next depends on the 
reset vector. The reset routine checks the reset vector to determine whether 
it is valid or not, as described later in this chapter in the section "The Reset 
Vector." If the reset was caused by turning the power on, the vector will not 
be valid, and the reset routine will perform the cold-start procedure. If the 
vector is valid, the routine will perform the warm-start, procedure. 
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9: 



For more information about ProDOS and 
the startup procedure, see the ProDOS 
Technical Reference Manual. 



The Cold-Start Procedure 

If the reset vector is not valid, either the Apple He has just been turned on 
or something has caused memory contents to be changed. The reset routine 
clears the display and puts the string Apple / / e (Apple nonan 
original He) at the top of the display. It loads the reset vector and the 
validity-check byte as described below, then starts checking the expansion 
slots to see if there is a disk drive controller card in one of them, starting 
with slot 7 and working down. 

If it finds a controller card, it initiates the startup (bootstrap) routine that 
resides in the controller card's firmware. The startup routine then loads 
DOS or ProDOS from the disk in drive 1. When the operating system has 
been loaded, it displays other messages on the screen. If there is no disk in 
the disk drive, the drive motor just keeps spinning until you press 

| CONTROL"}! RESET \ . 

If the reset routine doesn't find a controller card, or if you press 
I control H reset | again before the startup procedure has been completed, 
the reset routine will continue without using the disk, and pass control to 
the built-in Applesoft interpreter. 



Important! 



The Warm-Start Procedure 

Whenever you press I control H reset l when the Apple He has already- 
completed a cold-start reset, the reset vector is still valid and it is not 
necessary to reinitialize the entire system. The reset routine simply uses the 
vector to transfer control to the resident program, which is normally the 
built-in Applesoft interpreter. If the resident program is indeed Applesoft, 
your Applesoft program and variables are still intact. If you are using DOS, 
it is the resident program and it restarts either Applesoft or Integer BASIC, 
whichever you were using when you pressed | control H reset | . 

A program in bank-switched RAM cannot use the reset vector to regain 
control after a reset, because the Apple lie hardware enables ROM in the 
bank-switched memory space. If you are using Integer BASIC, which is in 
the bank-switched RAM, you are also using DOS, and it is DOS that 
controls the reset vector and restarts BASIC. 
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Forced Cold Start 

If a program has loaded the reset vector to point to the beginning of the 
program, as described in the next section, pressing | control H reset 1 
causes a warm-start reset that uses the vector to transfer control to that 
program. If you want to stop such a program without turning the power off 
and on, you can force a cold-start reset by holding down [3] and | control | , 
then pressing and releasing [ reset ] . 

Unconditional Restart: When you want to stop a program 
unconditionally— for example, to start up the Apple He with some other 
program— you should use the forced cold-start reset, 
fo U contro l"} ! reset j , instead of turning the power off and on. 

Whenever you press | control h reset | , firmware in the Apple He always 
checks to see whether either Apple key is down, If the g] key is down, with 
or without the [a] key, the firmware performs the self-test described later in 
this chapter. If only the [5] key is down, the firmware starts a forced 
cold-start reset. First, it destroys the program or data in memory by writing 
two bytes of arbitrary data into each page of main RAM. The two bytes that 
get written over in page 3 are the ones that contain the reset vector. The 
reset routine then performs a normal cold-start reset. 



The Reset Vector 



When you reset the Apple lie, the reset routine transfers control to the 
resident program by means of an address stored in page 3 of main RAM. 
This address is called a vector because it directs program control to a 
specified destination. There are several other vector addresses stored in 
page 3, as shown in Table 4-11, including the interrupt vectors described in 
the section "Interrupts on the Enhanced Apple He" in Chapter 6, and the 
ProDOS and DOS vectors described in the ProDOS Technical Reference 
Manual and the Apple II DOS Programmer's Manual. 

The cold-stait reset routine stores the starting address of the built-in 
Applesoft interpreter, low-order byte first, in the reset vector address at 
locations 1010 and 1011 (hexadecimal S03F2 and S03F3). It then stores a 
validity-check byte, also called the power-up byte, at location 1012 
(hexadecimal $03F4). The validity-check byte is computed by performing 
an exclusive-OR of the second byte of the vector with the constant 165 
(hexadecimal $A5). Each time you reset the Apple He, the reset routine uses 
this byte to determine whether the reset vector is still valid. 



The Reset Routine 



You can change the reset vector so that the reset routine will transfer 
control to your program instead of to the Applesoft interpreter. For this to 
work, you must also change the validity-check byte to the exclusive-OR of 
the high-order byte of your new reset vector with the constant 165 ($A5). If 
you fail to do this, then the next time you reset the Apple He, the reset 
routine will determine that the reset vector is invalid and perform a 
cold-start reset, eventually transferring control to the disk startup routine or 
to Applesoft. 

The reset routine has a subroutine that generates the validity-check byte 
for the current reset vector. You can use this subroutine by doing a 
subroutine call to location -1169 (hexadecimal $FB6F). When your program 
finishes, it can return the Apple lie to normal operation by restoring the 
original reset vector and again calling the subroutine to fix up the 
validity-check byte. 

Tableau. Page 3 Vectors 



Vector 
Address 

$3F0 
S3F1 

$3F2 
$3F3 

$3F4 

$3F5 
S3F6 
$3F7 

$3F8 
&3F9 

S3FA 

$3FB 
$3FC 
$3FD 



See "The User's Interrupt Handler at $3FE" S3FE 
in Chapter 6. $3FF 



Vector Function 

Address of the subroutine that handles BRK requests (normally 
$59, SFA). 

Reset vector (see text). 



Power-up byte (see text). 

Jump instruction to the subroutine that handles Applesoft & 
commands (normally $4C, S58, SFF). 

Jump instruction to the subroutine that handles user 
I control H T] commands. 

Jump instruction to the subroutine that handles non-maskable 
interrupts. 

Interrupt vector (address of the subroutine that handles 
interrupt requests). 



■ ■-. 
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Automatic Self-Test 



▲Warning 



If you reset the Apple lie by holding down [1] and | control ) while 
pressing and releasing | reset | , the reset routine will start running the 
built-in self-test. Successfully running this test assures you that the 
Apple lie is operational 

The self-test routine tests the Apple He's programmable memory by 
writing and then reading it. All programs and data in programmable 
memory when you run the self-test are destroyed, 

The self-test takes several seconds to run. The screen will display some 
patterns in low resolution mode which will change rapidly just before the 
self-test finishes. If the test finishes normally, the Apple He displays 
sy s t em OK and waits for you to restart, the system. 

If you have been running a program, some soft switches might be on when 
you run the self-test. If this happens, the self-test will display a message 
such as 

IOU FLAG ES: 1 

Turn the power off for several seconds, then turn it back on and run the 
self-test again. If it still fails, there is really something wrong; to get it 
corrected, contact your authorized Apple dealer for service. 



The Reset Routine 



Chapter 5 



Using the Monitor 




97 



The starting addresses for all of the 
standard subroutines are listed in 
Appendix B. 



The System Monitor is a set of subroutines in the Apple He firmware. The 
Monitor provides a standard interface to the built-in I/O devices described 
in Chapter 2. The I/O subroutines described in Chapter 3 are part of the 
System Monitor. 

ProDOS, DOS 3.3, and the BASIC interpreters use these subroutines by 
direct calls to their starting locations, as described for the I/O subroutines 
in Chapter 3. 

If you wish, you can call the standard subroutines from your programs in 
the same fashion. 

You can perform most of the Monitor functions directly from the keyboard. 
This chapter tells you how to use the Monitor to 

□ look at one or more memory locations 

□ change the contents of any location 

n write programs in machine language to be executed directly by the 
Apple He's microprocessor 

□ save blocks of data and programs onto cassette tape and read them back 
in again 

□ move and compare blocks of memory 

d search for data bytes and ASCII characters in memory 

□ invoke other programs from the Monitor 

□ invoke the Mini-Assembler. 



invoking the Monitor 



The System Monitor starts at memory location $FF69 (decimal 65385 
or -151). To invoke the Monitor, you make a CALL statement to this location 
from the keyboard or from a BASIC program. When the Monitor is riinning, 
its prompting character, an asterisk (*), appears on the left side of the 
display screen, followed by a blinking cursor. 

To use the Monitor, you type commands at the keyboard. When you have 
finished using the Monitor, you return to the BASIC language you were 
previously using by pressing | control H reset | , by pressing 
I control h fcl then | return | , or by typing 3dbg, which executes the 
resident program— usually Applesoft— whose address is stored in a jump 
instruction at location $31)0. 
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Syntax of Monitor Commands 



See "Summary of Monitor Commands" at 
the end of this chapter, 



To give a command to the Monitor, you type a line on the keyboard, then 
press | return | . The Monitor accepts the line using the standard I/O 
subroutine GETLN, described in Chapter 3. A Monitor command can be up 
to 255 characters in length, ending with a carriage return. 

A Monitor command can include three kinds of information: addresses, data 
values, and command characters. You type addresses and data values in 
hexadecimal notation. Hexadecimal notation uses the ten decimal digits 
(0-9) and the first six letters (A-F) to represent the sixteen values from 
to 15. A pair of hexadecimal digits represent values from to 255, 
corresponding to a byte, and a group of four hexadecimal digits can 
represent values from to 65,536, corresponding to a word. Any address in 
the Apple He can be represented by four hexadecimal digits. 

When the command you type calls for an address, the Monitor accepts any 
group of hexadecimal digits. If there are fewer than four digits in the group, 
it adds leading zeros; if there are more than four hexadecimal digits, the 
Monitor uses only the last four digits. It follows a similar procedure when 
the command syntax calls for two-digit data values. 

Each command you type consists of one command character, usually the 
first letter of the command name. When the command is a letter, it can be 
either uppercase or lowercase. The Monitor recognizes 23 different 
command characters. Some of them are punctuation marks, some are 
letters, and some are control characters. 

Note: Although the Monitor recognizes and interprets control characters 
typed on an input line, they do not appear on the screen. 

This chapter contains many examples of the use of Monitor commands. In 
the examples, the commands and values you type are shown in a normal 
typeface and the responses of the Monitor are in a computer typeface. Of 
course, when you perform the examples, all of the characters that appear 
on the display screen will be in the same typeface. Some of the data values 
displayed by your Apple He may differ from the values printed in these 
examples, because they are variables stored in programmable memory. 



Syntax of Monitor Commands 



Monitor Memory Commands 



When you use the Monitor to examine and change the contents of memory, 
it keeps track of the address of the last location whose value you inquired 
about and the address of the location that is next to have its value changed. 
These are called the last opened location and the next changeable location. 



Examining Memory Contents 

When you type the address of a memory location and press j return | , the 
Monitor responds with the address you typed, a dash, a space, and the value 
stored at that location, like this: 



*E000 

E000- 

•33 

0033- 



2i 



AA 



Each time the Monitor displays the value stored at a location, it saves the 
address of that location as the last opened location and as the next 
changeable location. 



Memory Dump 

When you type a period (.) followed by an address, and then press 
I return | , the Monitor displays a memory dump; the data values stored at 
all the memory locations from the one following the last opened location to 
the location whose address you typed following the period. The Monitor 
saves the last location displayed as both the last opened location and the 
next changeable location. In these examples, the amount of data displayed 
by the Monitor depends on how much larger than the last opened location 
the address after the period is. 



. 
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0020- 



0021- 
0028- 

•300 

0300- 

•.315 

030 1- 

0308- 
0310- 

*.32A 

0316- 
0318- 
8320- 
0328- 



28 00 13 0F 0C 00 00 
A8 06 D0 07 

99 

B9 00 08 0A 0A 0A 99 

00 08 C8 D0 F4 AS 2B A9 

09 85 27 AD CC 03 

85 41 

84 40 8A 4A 4A 4A 4A 09 

C0 85 3F A9 5D 85 3E 20 

43 03 20 



When the Monitor performs a memory dump, it starts at the location 
immediately following the last opened location and displays that address 
and the data value stored there. It then displays the values of successive 
locations up to and including the location whose address you typed, but 
only up to eight values on a line. When it reaches a location whose address 
is a multiple of eight— that is, one that ends with an 8 or a 0— it displays 
that address as the beginning of a new line, then continues displaying more 
values. 

After the Monitor has displayed the value at the location whose address you 
specified in the command, it stops the memory dump and sets that location 
as both the last opened location and the next changeable location. If the 
address specified on the input line is less than the address of the last 
opened location, the Monitor displays only the address and value of the 
location following the last opened location. 
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You can combine the two commands, opening a location and dumping 
memory, by simply concatenating them: type the first address, a period, and 
the second address. This combination of two addresses separated by a 
period is called a memory range. 

•300.32F 

0300- 39 B9 00 08 SA 0A 0A 99 

0308- 00 08 C8 D0 F4 A6 2B A9 

0310- 09 85 27 AD CC 03 85 41 

0318- 84 40 8A 4A 4A 4A 4A 09 

0320- C0 85 3F A9 5D 85 3E 20 

0328- 43 03 20 48 03 A5 3D 4D 

•30.40 

0030- AA 00 FF AA 05 C2 05 C2 
0038- 1B FD D0 03 3C 00 40 00 
0040- 30 

•E015.E025 

E016- 4C ED FD 

E018- A9 20 C5 24 B0 0C A9 8D 

E020- A0 07 20 ED FD A9 



Pressing I return I by itself causes the Monitor to display one line of a 
memory dump; that is, a memory dump from the location following the last 
opened location to the next multiple-of-eight boundary. The Monitor saves 
the address of the last location displayed as the last opened location and the 
next changeable location. 

•5 

0005- 00 



» | RETURN I 
00 00 

* | RETURN | 
0008- 00 00 

*32 

0032- FF 



00 00 00 00 00 00 



I RETURN 



AA 00 C2 05 C2 



* RETURN 



0038- 1B FD D0 03 3C 00 3F 00 
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▲Warning 



Changing Memory Contents 



The previous section showed you how to display the values stored in the 
Apple He's memory; this section shows you how to change those values. 
You can change any location in RAM— programmable memory— and you 
can also change the soft switches and output devices by changing the 
locations assigned to them. 

Use these commands carefully. If you change the zero-page locations 
used by Applesoft, ProDOS, or DOS, you may lose programs or data stored 
in memory. 



Changing One Byte 

The previous commands keep track of the next changeable location; these 
commands make use of it. In the next example, you open location 0, then 
type a colon (:) followed by a value. 



•0 

0000 

•:5F 



03 



The contents of the next changeable location have just been changed to the 
value you typed, as you can see by examining that location: 

*0 

0000- 5F 

* 

You can also combine opening and changing into one operation by typing an 
address followed by a colon and a value. In the example, you type the 
address again to verify the change. 

♦302:42 

•302 

0302- 42 

♦ 

When you change the contents of a location, the value that was contained 
in that location disappears, never to be seen again. The new value will 
remain until you replace it with another value. 
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Changing Consecutive Locations 

You don't have to type a separate command with an address, a colon, a 
value, and | return ] for each location you want to change. You can change 
the values of up to 85 consecutive locations at a time (or even more, if you 
omit leading zeros from the values) by typing only the initial address and 
colon followed by all the values separated by spaces, and ending with 
[ return | . The Monitor will duly store the consecutive values in 
consecutive locations, starting at the location whose address you typed. 
After it has processed the string of values, it takes the location following the 
last changed location as the next changeable location. Thus, you can 
continue changing consecutive locations without typing an address on the 
next input line by typing another colon and more values. In these examples, 
you first change some locations, then examine them to verify the changes. 

•300;69012GEDFD4C03 

•300 

0300- 69 

» | RETURN 1 

01 20 ED FD 4C 00 03 

♦10:0123 

*:4567 

♦10.17 

6010- 00 01 02 03 04 05 06 07 



ASCII Input Mode 

The enhanced Apple He has an ASCII input mode that lets you enter ASCII 
characters just as you can their hexadecimal ASCII equivalents by 
preceding the literal character with an apostrophe ('). This means that 'A is 
the same as $C1 and 'B is the same as $C2 to the Monitor. The ASCII value 
for any character following an apostrophe is used by the Monitor. 
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Each character to be placed in memory should be delimited by a leading 
apostrophe (') and a trailing space. The only exception to this rule is that 
the last character in the line is followed with a return character instead of a 
space. The following example would enter the string "Hooray for sushi!" at 
$0300 in memory. 

*300:'H 'o 'o 'r 'a *y ' 'f o 'r ' 's *u 's 'h 'i '! 



ASCII input mode sets the high bit of the code for a character that you 
enter. So 'A will equal $C1, not $41. 



Important! 
Original He I The original Apple He does not have an ASCII input mode. 



Moving Data in Memory 

You can copy a block of data stored in a range of memory locations from one 
area in memory to another by using the Monitor's MOVE command. To 
move a range of memory, you must tell the Monitor both where the data is 
now situated in memory (the source locations) and where you want the 
copy to go (the destination locations). You give this information to the 
Monitor by means of three addresses; the address of the first location in the 
destination and the addresses of the first and last locations in the source. . 
You specify the starting and ending addresses of the source range by 
separating them with a period. You separate the destination address from 
the range addresses with a less-than character (<), which you may think 
of as an arrow pointing in the direction of the move. Finally, you tell the 
Monitor that this is a MOVE command by typing the letter M (in either 
lowercase or uppercase). The format of the complete MOVE command looks 
like this: 



J destination} 



< 



[start] 



lend! M 



When you type the actual command, the words in braces should be replaced 
by hexadecimal addresses, and the braces and spaces should be omitted. 
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Here are some examples of Monitor commands, including some memory 
moves. First, you examine the values stored in one range of memory, then 
store several values in another range of memory; the actual MOVE 
commands end with the letter M. 

•0.F 

0000- 5F 00 05 07 00 00 00 00 
08- 00 00 00 00 00 00 00 00 

•300:A9 8D 20 ED FD A9 45 20 DA FD 4C 00 03 
•300.30C 

0300- A3 8D 20 ED FD A3 45 20 
0308- DA FD 4C 00 03 

•0<300.30CM 
*0.C 

0000- A9 8D 20 ED FD A9 45 20 
0008- DA FD 4C 00 03 

*310<8.AM 
•310.312 

0310- DA FD 4C 

«2<7.9M 
*0.C 

0000- A9 8D 20 DA FD A3 45 20 
0008- DA FD 4C 00 03 



See the section "Special Tricks With the 
Monitor" later in this chapter for an 
interesting application of this feature. 



The Monitor moves a copy of the data stored in the source range of locations 
to the destination locations. The values in the source range are left 
undisturbed. The Monitor remembers the last location in the source range 
as the last opened location, and the first location in the source range as the 
next changeable location. If the second address in the source range 
specification is less than the first, then only one value (that of the first 
location in the range) will be moved. 

If the destination address of the MOVE command is inside the source range 
of addresses, then strange (and sometimes wonderful) things happen: the 
locations between the beginning of the source range and the destination 
address are treated as a sub-range and the values in this sub-range are 
replicated throughout the source range. 
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Comparing Data in Memory 

You can use the VERIFY command to compare two ranges of memory using 
the same format you use to move a range of memory from one place to 
another. In fact, the VERIFY command can be used immediately after a 
MOVE command to make sure that the move was successful. 

The VERIFY command, like the MOVE command, needs a range and a 
destination. The syntax of the VERIFY command is 

{destination) < {start]- . {end} V 

The Monitor compares the values in the source locations with the values in 
the locations beginning at the destination address. If any values don't 
match, the Monitor displays the address at which the discrepancy was 
found and the two values that differ. In the example, you store data values 
in the range of locations from to $D, copy them to locations starting at 
$300 with the MOVE command, and then compare them using the VERIFY 
command. When you use the VERIFY command after you change the value 
at location 6 to $E4, it detects the change. 

•0:D7 F2 E9 F4 F4 E5 EE A0 E2 F9 A0 C3 C4 C5 

*300<0.DM 

•300<0.DV 

•6:E4 

•300<0.DV 

0006-E4 CEE) 



See the section "Special Tricks With the 
Monitor" later in this chapter. 



If the VERIFY command finds a discrepancy, it displays the address of the 
location in the source range whose value differs from its counterpart in the 
destination range, If there is no discrepancy, VERIFY displays nothing. The 
VERIFY command leaves the values in both ranges unchanged. The last 
opened location is the last location in the source range, and the next 
changeable location is the first location in the source range, just as in the 
MOVE command. If the ending address of the range is less than the starting 
address, the values of only the first locations in the ranges will be 
compared. Like the MOVE command, the VERIFY command also does 
unusual things if the destination address is within the source range. 
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Searching for Bytes in Memory 



The SEARCH command lets you search for one or two bytes (either 
hexadecimal values or ASCII characters) in a range of memory. You must 
type in the ASCII string (or hexadecimal number or numbers) in reverse of 
the order that they appear in memory. Think of the SEARCH command as 
looking for items in a last-in, first-out queue. 

The syntax of the SEARCH command is 

{value or ASCII J < jstartj .jendj-S 

If the byte (or two byte sequence) that you specify is in the specified 
memory range, the Monitor will return with a list of the addresses where 
that byte (or byte sequence) occurs. If the byte (or byte sequence) is not in 
the range, the Monitor just displays the prompt. 

The following example looks for the character string LO in memory 
between $0300 and $03FF. 

*'O'L<300.3FFS 



Original He 



High Bit Set: Remember that ASCII input mode sets the high-order bit of 
each character that you enter. 

The next example searches for the two-byte sequence $FF11. 

*11FF<300.3FFS 

You can't search for a two-byte sequence with a high byte of 0. The Monitor 
ignores the high byte and searches for the low byte only. The sequence 
00FF is seen by the Monitor SEARCH command as FF. 

The Monitor in the original Apple lie does not recognize the SEARCH 
command. 



Examining and Changing Registers 

The microprocessor's register contents change continuously whenever the 
Apple He is running any sort of program, such as the Monitor. The Monitor 
lets you see what the register contents were when you invoked the Monitor 
or a program that you were debugging stopped at a break (BRK). The 
Monitor also lets you set 65C02 register values before you execute a 
program with the GO command. 
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When you call the Monitor, it stores the contents of the microprocessor's 
registers in memory. The registers are stored in the order A, X, Y, P 
(processor status register), and S (stack pointer), starting at location $45 
(decimal 69). When you give the Monitor a GO command, the Monitor loads 
the registers from these five locations before it executes the first instruction 
in your program. 

Pressing | control H T] and then I return ] invokes the Monitor's EXAMINE 
command, which displays the stored register values and sets the location 
containing the contents of the A register as the next changeable location. 
After using the EXAMINE command, you can change the values in these 
locations by typing a colon and then typing the new values separated by 
spaces. In the following example, you display the registers, change the first 
two, and then display them again to verify the change. 



CONTROL If !] 



A-0A X-FF 

»:B0Q2 



Y-D8 P-B0 S-F8 



* | controlXT) 

a=b0 x=02 y=d8 p=b8 s = f8 



Monitor Cassette Tape Commands 



The Apple He has two jacks for connecting an audio cassette tape recorder. 
With a recorder connected, you can use the Monitor commands described 
later in this section to save the contents of a range of memory onto a 
standard cassette and recall it for later use. 



Saving Data on Tape 

The Monitor's WRITE command saves the contents of up to 65,536 memory 
locations on cassette tape. To save a range of memory on tape, give the 
Monitor the starting and ending addresses of the range, followed by the 
letter W (for WRITE), like this: 

I start! . lend! W 
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Don't press | return | yet: first, put the tape recorder in record mode and let 
the tape run for a second, then press 1 return | . The Monitor will write a 
ten-second tone onto the tape and then write the data. The tone acts as a 
leader: later, when the Monitor reads the tape, the leader enables the 
Monitor to get in step with the signal from the tape. When the Monitor is 
finished writing the range you specified, it will sound a bell (beep) and 
display a prompt. You should rewind the tape and label it with the memory 
range that's on the tape and what it's supposed to be. 

Here's a small example you can save and use later to try out the READ 
command. Remember that you must start the cassette recorder in record 
mode before you press | return | after typing the WRITE command. 

»0:FF FF AD 30 CO 88 DO 04 C6 01 F0 08 CA 
D0F6A600 4C02 00 60 

•0.14 

0800- FF FF AD 30 C0 88 D0 04 
0008- C6 01 F0 08 CA D0 F6 A6 
0010- 00 4C 02 00 €0 

•0.14W 



It takes about 35 seconds total to save the values of 4,096 memory locations 
preceded by the ten-second leader onto tape. This works out to an average 
data transfer rate of about 1,350 bits per second. 

The WRITE command writes one extra value on the tape after it has 
written the values in the memory range. This extra value is the checksum, 
which is the eight-bit partial sum of all values in the range. When the 
Monitor reads the tape, it uses this value to determine if the data has been 
written and read correctly. (See the next section.) 



Reading Data From Tape 

Once you've saved a memory range onto tape with the Monitor's WRITE 
command, you can read that memory range back into the computer by- 
using the Monitor's READ command. The data values you've stored on the 
tape need not be read back into the same memory range from whence they 
came; you can tell the Monitor to put those values into any memory range in 
the computer's memory, provided that it's the same size as the range you 
saved. 
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The format of the READ command is the same as that of the WRITE 
command, except that the command letter is R: 

{start} . jend[ R 

Once again, after typing the command, don't press | return | . Instead, start 
the tape recorder in play mode and wait a few seconds. Although the 
WRITE command puts a ten-second leader tone on the beginning of the 
tape, the READ command needs only three seconds of this leader to lock on 
to the signal from the tape. You should let a few seconds of tape go by before 
you press | return i to allow the tape recorder's output to settle down to a 
steady tone. 

This example has two parts. First, you set a range of memory to zero, verify 
the contents of memory, and then type the READ command, but don't press 
I return I. 



•0:000000000000000000000 

•0.14 

0000- 00 00 00 00 00 00 
0006- 00 00 00 00 00 00 00 00 
0010- 00 00 

•0.14R 

Now start the cassette running in play mode, wait a few seconds, and press 
I return | . After the Monitor sounds the bell (beep) and displays the prompt, 
examine the range of memory to see that the values from the tape were 
read correctly: 

•0.14 

0000- FF FF AD 30 C0 88 D0 04 

0008- C6 01 F0 08 CA D0 F6 AG 

0010- 00 4C 02 00 60 

* 

After the Monitor has read all the data values on the tape, it reads the 
checksum value. It computes the checksum on the data it read and 
compares it to the checksum from the tape. If the two checksums differ, the 
Monitor sends a beep to the speaker and displays err. This warns you that 
there was a problem reading the tape and that the values stored in memory 
aren't the values that were recorded on the tape. If the two checksums 
match, the Monitor will just send out a beep and display a prompt. 
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Miscellaneous Monitor Commands 



These Monitor commands enable you to change the video display format 
from normal to inverse and back, and to assign input and output to 
accessories in expansion slots. 



Inverse and Normal Display 

You can control the setting of the inverse-normal mask location used by the 
COUT subroutine (described in Chapter 3) from the Monitor so that all of 
the Monitor's output will be in inverse format. The INVERSE command, I, 
sets the mask such that all subsequent inputs and outputs are displayed in 
inverse format, To switch the Monitor's output back to normal format, use 
the NORMAL command, N. 

•O.F 

0000- 0A 0B 0C 0D 0E 0F D0 04 
0008- CG 01 F0 08 CA D0 F6 A6 
•1 

•O.F 

0000- 0A 0B 00 0D 0E 0F D0 04 
0008- C6 01 F0 08 CA D0 FG AG 

•O.F 

0000- 0A 0B 0C 0D 0E 0F D0 04 
0008- CG 01 F0 08 CA D0 F6 AG 



Back to BASIC 



Use the BASIC command, I control h |T|, to leave the Monitor and enter the 
BASIC that was active when you entered the Monitor. Normally, this is 
Applesoft BASIC, unless you deliberately switched to Integer BASIC. Any 
program or variables that you had previously in BASIG will be lost. If you 
want to reenter BASIC with your previous program and variables intact, use 
the CONTINUE BASIC command, | control H c~l. 
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If you are using DOS 3.3 or ProDOS, press I control H reset | or type 

3DBG 

to return to the language you were using, with your program and variables 
intact. 

That's a Number Not a Letter: If you use 3D0G, make sure that the 
third character you type is a zero, not a letter 0. The letter G is the 
Monitor's GO command, described in the section "Machine-Language 
Programs" later in this chapter. 



▲Warning 



Redirecting Input and Output 

The PRINTER command, activated by a | control H "p1, diverts all output 
normally destined for the screen to an interface card in a specified 
expansion slot, from 1 to 7. There must be an interface card in the specified 
slot, or you will lose control of the computer and your program and variables 
may be lost. The format of the command is 

jslot number} | control H ~p] 

A PRINTER command to slot number will switch the stream of output 
characters back to the Apple He's video display. 

Don't give the PRINTER command with slot number to deactivate the 
80-column firmware, even though you used this command to activate it in 
slot 3. The command works, but it just disconnects the firmware, leaving 
some of the soft switches set for SO-column display. 

In much the same way that the PRINTER command switches the output 
stream, the KEYBOARD command substitutes the interface card in a 
specified expansion slot for the Apple He's normal input device, the 
keyboard. The format for the KEYBOARD command is 



A slot number of for the KEYBOARD command directs the Monitor to 
accept input from the Apple lie's built-in keyboard. 

The PRINTER and KEYBOARD commands are the exact equivalents of the 
BASIC commands PR# and IN#. 
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Hexadecimal Arithmetic 

The Monitor will also perform one-byte hexadecimal addition and 
subtraction. Just type a line in one of these formats: 

j value] + | valuej 
j value} - [value | 

The Apple He performs the arithmetic and displays the result, as shown in 
these examples: 

•20+13 

= 33 

•4A-C 

-3E 

•FF+4 

-03 

•3-4 

«FF 



Special Tricks With the Monitor 

This section describes some more complex ways of using the Monitor 
commands. 



Multiple Commands 

You can put as many Monitor commands on a single line as you like, as long 
as you separate them with spaces and the total number of characters in the 
line is less than 254. Adjacent single-letter commands such as L, S, I, and N 
need not be separated by spaces. 

You can freely intermix all of the commands except the STORE (:) 
command. Since the Monitor takes all values following a colon and places 
them in consecutive memory locations, the last value in a STORE must be 
followed by a letter command before another address is encountered. You 
can use the NORMAL command as the required letter command in such 
cases; it usually has no effect and can be used anywhere. 
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In the following example, you display a range of memory, change it, and 
display it again, all with one line of commands. 

►300.307 300:18 69 1 N 300.302 

0300- 00 00 00 00 00 00 00 00 
0300- 18 £9 01 



If the Monitor encounters a character in the input line that it does not 
recognize as either a hexadecimal digit or a valid command character, it 
executes all the commands on the input line up to that character, then 
grinds to a halt with a noisy beep and ignores the remainder of the input 
line. 



Filling Memory 

The MOVE command can be used to replicate a pattern of values 
throughout a range of memory. To do this, first store the pattern in the first 
locations in the range: 

•300:1122 33 



Remember the number of values in the pattern: in this case, it is 3. Use the 
number to compute addresses for the MOVE command, like this: 

jstart+ number j < j start} . {end-number} M 

This MOVE command will first replicate the pattern at the locations 
immediately following the original pattern, then replicate that pattern 
following itself, and so on until it fills the entire range. 

•303O00.32DM 

•300.32F 

0300- 11 22 33 1 1 22 33 11 22 
0308- 33 11 22 33 11 22 33 11 
0310- 22 33 11 22 33 11 22 33 
0318- 1 1 22 33 1 1 22 33 1 1 22 
0320- 33 11 22 33 1 1 22 33 11 
0328- 22 33 11 22 33 11 22 33 



i 
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You can do a similar trick with the VERIFY command to check whether a 
pattern repeats itself through memory. This is especially useful to verify 
that a given range of memory locations all contain the same value. In this 
example, you first fill the memory range from $0300 to $0320 with zeros and 
verify it, then change one location and verify again, to see the VERIFY 
command detect the discrepancy; 

•300:0 

•30K300.31FM 

•30K900.31FV 

•304:02 

•30K300.31FV 

0303-00 (02) 
0304-02 C00) 



Repeating Commands 

You can create a command line that repeats one or more commands over 
and over. You do this by beginning the part of the command line that you 
want to repeat with a letter command, such as N, and ending it with the 
sequence 34;n, where n is a hexadecimal number that specifies the position 
in the line of the command where you want to start repeating; for the first 
character in the line, n=0. The value for n must be followed with a space in 
order for the loop to work properly. 

This trick takes advantage of the fact that the Monitor uses an index 
register to step through the input buffer, starting at location $0200. Each 
time the Monitor executes a command, it stores the value of the index at 
location $34; when that command is finished, the Monitor reloads the index 
register with the value at location $34. By making the last command change 
the value at location $34, you change this index so that the Monitor picks up 
the next command character from an earlier point in the buffer. 
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The only way to stop a loop like this is to press | control H reset 1 ; that is 
how this example ends. 



•N 300 302 34:0 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


030 




* 





Creating Your Own Commands 

The USER command, I control H TT, forces the Monitor to jump to memory 
location $03F8. You can put a JMP instruction there that jumps to your own 
machine-language program. Your program can then examine the Monitor's 
registers and pointers or the input buffer itself to obtain its data. For 
example, here is a program that displays everything on the input line after 
the I control rf Tl The program starts at location $0300; the command line 
that starts with S03F8 stores a jump to $0300 at location $03F8. 

*300:A4 34 B9 00 02 20 ED FD C8 C9 8D DO F5 4C 69 FF 

•3F8;4C0003 

» | control r TYl THIS IS A TEST 

THIS IS A TEST 
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Machine-Language Programs 



The main reason to program in machine language is to get more speed. A 
program in machine language can run much faster than the same program 
written in high-level languages such as BASIC or Pascal, but the 
machine-language version usually takes a lot longer to write. There are 
other reasons to use machine language: you might want your program to do 
something that isn't included in your high-level language, or you might just 
enjoy the challenge of using machine language to work directly on the bits 
and bytes. 

Boning Up on Machine Language: If you have never used machine 
language before, you'll need to learn the 65C02 instructions listed in 
Appendix A. To become proficient at programming in machine language, 
you'll have to spend some time at it and study at least one of the books on 
6502 programming listed in the bibliography, With the books and 
Appendix A, you'll have the needed information to program the 65C02. 

You can get a hexadecimal dump of your program, move it around in 
memory, or save it on tape and recall it using the commands described in 
the previous sections. The Monitor commands in this section are intended 
specifically for you to use in creating, writing, and debugging 
machine-language programs. 



Running a Program 

The Monitor command you use to start execution of your machine-language 
program is the GO command. When you type an address and the letter G, 
the Apple lie starts executing machine language instructions starting at the 
specified location. If you just type the G, execution starts at the last opened 
location. The Monitor treats this program as a subroutine: it should end with 
an RTS (return from subroutine) instruction to transfer control back to the 
Monitor. 
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The Monitor has some special features that make it easier for you to write 
and debug machine-language programs, but before you get into that, here is 
a small machine-language program that you can run using only the simple 
Monitor commands already described. The program in the example merely 
displays the letters A through Z: you store it starting at location $0300, 
examine it to be sure you typed it correctly, then type 300G to start it 
running. 

•300:A9 CI 20 ED FD 18 69 1 C9 DB DO F6 60 

•300.3GC 

0300- A9 C1 20 ED FD 18 69 01 
0308- C9 DB D0 F6 60 

*300G 

ABCDEFGHUKLMNOPGRSTUVWXYZ 



The word mnemonic comes from the same 
root as memory and refers to 
abbreviations that are easier to remember 
than the hexadecimal operation codes 
themselves: for example, for clear carry 
voii write CLC instead of $18. 



Disassembled Programs 

Machine-language code in hexadecimal isn't the easiest thing in the world 
to read and understand. To make this job a little easier, machine-language 
programs are usually written in assembly language and converted into 
machine-language code by programs called assemblers. 

Since programs that translate assembly language into machine language are 
called assemblers, a program like the Monitor's LIST command that 
translates machine language into assembly language is called a 
disassembler. 

The Monitor's LIST command displays machine-language code in 
assembly-language form. Instead of unformatted hexadecimal gibberish, the 
LIST command displays each instruction on a separate line, with a 
three-letter instruction name, or mnemonic, and a formatted hexadecimal 
operand. The LIST command also converts the relative addresses used in 
branch instructions to absolute addresses. 

The Monitor LIST command has the format 

j location j L 



g 
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The LIST command starts at the specified location and displays as much 
memory as it takes to make up a screenfull (20 lines) of instructions, as 
shown in the following example: 

•300L 



0300- 


A3 


C1 


LDA 


'•CI 


0302- 


1% 


ED FD 


JSR 


$FDED 


0306- 


18 




CLC 




0306- 


69 


01 


ADC 


f||1 


0308- 


C9 


DB 


CMP 


'*DB 


030A- 


D0 


F6 


BNE 


$0302 


030C- 


60 




RTS 




030D- 


e? 




BRK 




I3IE- 


ee 




BRK 




03IF- 


00 




BRK 




§310- 


00 




BRK 




0311- 


00 




BRK 




0312- 


20 




BRK 




0313- 


00 




BRK 




0314- 


00 




BRK 




0316- 


00 




BRK 




0316- 


00 




BRK 




0317- 


00 




BRK 




0318- 


00 




BRK 




0319- 


00 




BRK 





The first seven lines of this example are the assembly-language form of the 
program you typed in the previous example. The rest of the lines are BRK 
instructions only if this part of memory has zeros in it: other values will be 
disassembled as other instructions. 

The Monitor saves the address that you specify in the LIST command, but 
not as the last opened location used by the other commands. Instead, the 
Monitor saves this address as the program counter, which it uses only to 
point to locations within programs. Whenever the Monitor performs a LIST 
command, it sets the program counter to point to the location immediately 
following the last location displayed on the screen, so that if you type 
another LIST command it will display another screenful of instructions, 
starting where the previous display left off. 
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The Mini-Assembler 



Without an assembler, you have to write your machine language program, 
take the hexadecimal values for the opcodes and operands, and store them 
in memory using the commands covered in the previous sections. That is 
exactly what you did when you ran the previous examples. 

The Monitor includes an assembler called the Mini-Assembler that lets you 
enter machine-language programs directly from the keyboard of your Apple. 
ASCII characters can be entered in Mini- Assembler programs, exactly as 
you enter them in the Monitor. Note that the Mini-Assembler doesn't accept 
labels; you must use actual values and addresses. 



Starting the Mini-Assembler 

To start the Mini-Assembler first invoke the Monitor by typing call - 1 5 1 
I return ] , and then from the Monitor, type ! followed by I return | . The 
Monitor prompt character then changes from • to ! . 

When you finish using the Mini- Assembler, press I return | from a blank 
line to return to the Monitor. 



Original lie 



Restrictions 

The Mini- Assembler supports only the subset of 65C02 instructions that are 
found on the 6502. 

Before you can use the Mini- Assembler on the original Apple He, you have 
to be running Integer BASIC. When you start up the computer using DOS 
or either BASIC, the Apple He loads the Integer BASIC interpreter from 
the file named INTBASIC into the bank-switched RAM. Here's how to 
start the Mini-Assembler on an original Apple He; 



1. Start Integer BASIC from DOS 3.3 by typing i nt | return | . 

2. After the Integer prompt character (> ) and a cursor appear, enter 
the Monitor by typing c a l l - 1 5 1 1 return | . 

3. Now start the Mini-Assembler by typing f GG6G I return | . 
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Formats for operands are listed in Table 

5-1. 



Using the Mini-Assembler 

The Mini-Assembler saves one address, that of the program counter. Before 
you start to type a program, you must set the program counter to point to 
the location where you want the Mini-Assembler to store your program. Do 
this by typing the address followed by a colon. 

After the colon, type the mnemonic for the first instruction in your program, 
followed b y a space and the operand of the instruction. Now press 
I return | . The Mini-Assembler converts the line you typed into 
hexadecimal, stores it in memory beginning at the location of the program 
counter, and then disassembles it again and displays the disassembled line. 
It then displays a prompt on the next line. 

Now the Mini-Assembler is ready to accept the second instruction in your 
program. To tell it that you want the next instruction to follow the first, 
don't type an address or a colon; just type a space and the next instruction's 
mnemonic and operand, then press | return | . The Mini-Assembler 
assembles that line and waits for another. 



■300:LDX#02 

0300- A2 02 

! LDA $0,X 

0302- B5 00 

!STA$10,X 

0304 95 10 

! DEX 

0306- CA 

! STA $C030 

8307- 8D 30 C0 

• BPL $302 

030A- 10 F6 

• BRK 



LDX #$02 

LDA $00, X 

STA $10, X 
DEX 



STA 



BPL 



$C030 



$0302 



030C- 



18 



BRK 



If the line you type has an error in it, the Mini-Assembler beeps loudly and 
displays a caret ( " ) under or near the offending character in the input line. 
Most common errors are the result of typographical mistakes: misspelled 
mnemonics, missing parentheses, and so forth. The Mini-Assembler also 
rejects the input line if you forget the space before or after a mnemonic or 
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include an extraneous character in a hexadecimal value or address. If the 
destination address of a branch instruction is out of the range of the branch 
(more than 127 locations distant from the address of the instruction), the 
Mini- Assembler flags this as an error. 

There are several different ways to leave the Mini- Assembler and reenter 
the Monitor. On an enhanced Apple He only, simply press I return | at a 
blank line. 

Original lie I On an original Apple He, type the Monitor command $FF69G. 

On any Apple lie, you can press | control H reset | , which warm starts 
BASIC, then type 

CALL -151 

Your assembly language program is now stored in memory, You can display 
it with the LIST command; 

*3001 



0300- 


A2 


02 


LDX 


*$02 


0302- 


B5 


00 


LDA 


$00, X 


0304- 


95 


13 


STA 


$10, X 


0306- 


CA 




DEX 




0307- 


8D 


30 C0 


STA 


$C030 


030A- 


10 


F6 


BPL 


$0302 


030C- 


00 




BRK 




030D- 


00 




BRK 




030E- 


00 




BRK 




030F- 


00 




BRK 




0310- 


08 




BRK 




0311- 







BRK 




0312- 







BRK 




0313- 


00 




BRK 




0314- 


00 




BRK 




0316- 


00 




BRK 




0316- 


00 




BRK 




0317- 


00 




BRK 




0318- 


00 




BRK 




0319- 


00 




BRK 
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See Appendix A for more information about 
65C02 (and 6502) instructions. 



Mini-Assembler Instruction Formats 

The Apple Mini-Assembler recognizes 56 mnemonics and 13 addressing 
formats. These constitute the 6502 subset of the 65C02 instruction set. The 
mnemonics are standard, as used in the Synertek Programming Manual 
(Apple part number A2L0003), but the addressing formats are somewhat 
different. Table 5-1 shows the Apple standard address-mode formats for 
6502 assembly language. 

Table 5-1. Mini-Assembler Address Formats 






Addressing Mode 

Accumulator 
Implied 
Immediate 
Absolute 
Zero page 
Indexed zero page 

Indexed absolute 

Relative 

Indexed indirect 
Indirect indexed 
Absolute indirect 



Format 



#${value} 

${address} 

${address} 

${address},X 
${address},Y 

SladdresskX 
${address},Y 

Sjaddress} 

(${address},X) 

(${address}),Y 

(${address|) 



* These instructions have no operands. 



An address consists of one or more hexadecimal digits. The Mini-Assembler 
interprets addresses the same way the Monitor does: if an address has fewer 
than four digits, the Mini-Assembler adds leading zeros; if the address has 
more than four digits, then it uses only the last four. 

Dollar Signs: In this manual, dollar signs ($) in addresses signify that 
the addresses are in hexadecimal notation. They are ignored by the 
Mini- Assembler and may be omitted when typing programs. 
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There is no syntactical distinction between the absolute and zero-page 
addressing modes. If you give an instruction to the Mini- Assembler that can 
be used in both absolute and zero-page mode, the Mini- Assembler assembles 
that instruction in absolute mode if the operand for that instruction is 
greater than $FF, and it assembles it in zero-page mode if the operand is less 
than $0100. 

Instructions in accumulator mode and implied addressing mode need no 
operands. 

Branch instructions, which use the relative addressing moae, require the 
target address of the branch. The Mini-Assembler calculates the relative 
distance to use in the instruction automatically. If the target address is more 
than 127 locations distant from the instruction, the Mini-Assembler sounds 
a bell (beep), displays a caret ( * ) under the target address, and does not 
assemble the line. 

If you give the Mini-Assembler the mnemonic for an instruction and an 
operand, and the addressing mode of the operand cannot be used with the 
instruction you entered, the Mini- Assembler will not accept the line. 



Summary of Monitor Commands 



Here is a summary of the Monitor commands, showing the syntax for each 
one. 



Examining Memory 



|adrs} 
(adrsl}.|adrs2f 


Examines the value contained in 
one location. 

Displays the values contained in all 
locations between jadrsl} and 

]adrs2|. 


| RETURN 1 


Displays the values in up to eight 
locations following the last opened 
location. 
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Changing the Contents of Memory 



Jadrsj:{val] {val[. 



:|val||val|. 



Stores the values in consecutive 
memory locations starting at jadrsj. 
Stores values in memory starting at 
the next changeable location. 



Moving and Comparing 



jdestj< [start j.jendjM 



idestj<!start[.jend]V 



Copies the values in the range 
]start|.|endj into the range 
beginning at jdestj. 

Compares the values in the range 
jstartj.jendj- to those in the range 
beginning at [destj. 



The Examine Command 



CONTROL H IT 



Displays the locations where the 
contents of the 65C02's registers are 
stored and opens them for changing. 



The Search Command 



Jval[<jstartj.|end|S 



Displays the address of the first 
occurrence of jvalj in the specified 
range beginning at jstartf. 



Cassette Tape Commands 

J start), {end jW 



[start [.[endjR 



Writes the values in the memory 
range |startj.[endf onto tape, 
preceded by a ten-second leader. 
Reads values from tape, storing 
them in memory beginning at [start] 
and stopping at jend]. Prints err if 
an error occurs. 
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Miscellaneous Monitor Commands 



I 

N 



CONTROL | [B 



| CONTROL | |~C~1 



|valj+jvalj 



[valj-|val| 



jSloti rCONTROLi rPl 



CONTROL | |T1 



Sets inverse display mode. 

Sets normal display mode. 

Enters the language currently active 

(usually Applesoft). 

Returns to the language currently 

active (usually Applesoft). 

Adds the two values and prints the 

hexadecimal result. 

Subtracts the second value from the 

first and prints the result, 

Diverts output to the device whose 

interface card is in slot number 

| slot | . If [slot]=0, accepts input from 

the keyboard. 

Jumps to the machine-language 

subroutine at location $3F8. 



Running and Listing Programs 



adrs G 



ladrsIL 



Transfers control to the machine 

language program beginning at 

[adrs}. 

Disassembles and displays 20 

instructions, starting at jadrsj. 

Subsequent LIST commands 

display 20 more instructions. 
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The Mini-Assembler 

Original lie The Mini-Assembler is available on an original Apple He only when 
Integer BASIC is active. See the earlier section "The Mini-Assembler." 



F666G 
! 

^command] 

SFF69G 

I RETURN | 



Invokes the Mini-Assembler on the 

original Apple He. 

Invokes the Mini-Assembler on the 

enhanced Apple He. 

Executes a Monitor command from 

the Mini-Assembler on the original 

Apple lie. 

Leaves the Mini-Assembler on the 

original Apple He. 

Leaves the Mini-Assembler on the 

enhanced Apple He. 
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Programming for Peripheral Cards 
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II Plus, II 



Original He 



The seven expansion slots on the Apple He's main circuit board are used for 
installing circuit cards containing the hardware and firmware needed to 
interface peripheral devices to the Apple lie. These slots are not simple I/O 
ports; peripheral cards can access the Apple lie's data, address, and control 
lines via these slots. The expansion slots are numbered from 1 to 7, and 
certain signals, described below, are used to select a specific slot. 

The Apple II and Apple II Plus have an eighth expansion slot: slot 
number 0. On those models, slot is normally used for a language card or 
a ROM card; the functions of the Apple II Language Card are built into the 
main circuit board of the Apple lie. 

Interrupt support on the enhanced Apple He requires that special attention 
be paid to cards designed to be in slot 3. A description of what you need to 
watch for is given at the end of this chapter. 

The interrupt support built into the enhanced Apple He is an enhanced 
and expanded version of the interrupt support in the original Apple He. 



Peripheral-Card Memory Spaces 



Because the Apple He's microprocessor does all of its I/O through memory 
locations, portions of the Apple He's memory space have been allocated for 
the exclusive use of the cards in the expansion slots. In addition to the 
memory locations used for actual I/O, there are memory spaces available 
for programmable memory (RAM) in the main memory and for read-only 
memory (ROM or PROM) on the peripheral cards themselves. 

The memory spaces allocated for the peripheral cards are described below. 
Those memory spaces are used for small dedicated programs such as I/O 
drivers. Peripheral cards that contain their own driver routines in firmware 
like this are called intelligent peripherals. They make it possible for you to 
add peripheral hardware to your Apple lie without having to change your 
programs, provided that your programs follow normal practice for data 
input and output. 



Peripheral-Card I/O Space 

Each expansion slot has the exclusive use of sixteen memory locations for 
data input and output in the memory space beginning at location $C090. 
Slot 1 uses locations SC090 through $C09F, slot 2 uses locations SC0A0 
through $C0AF, and so on through location SCOFF, as shown in Table 6-1. 



130 



Chapter 6: Programming for Peripheral Cards 



Signals for which the active state is low are 
marked with a prime ('). 



These memory locations are used for different I/O functions, depending on 
the design of each peripheral card. Whenever the Apple lie addresses one of 
the sixteen I/O locations allocated to a particular slot, the signal on pin 41 
of that slot, called DEVICE SELECT', switches to the active (low) state. 
This signal can be used to enable logic on the peripheral card that uses the 
four low-order address lines to determine which of its sixteen I/O locations 
is being accessed. 



Table 6-1. Peripheral-Card I/O Memory Locations Enabled by DEVICE SELEC T' 

Locations Slot 

$C090-SC09F 5 

$C0AO-$COAF 6 

SC0B0-$C0BF 7 
$COC0-$COCF 



Slot 

1 
2 
3 

4 



Locations 

$CODO-$C0DF 
$C0E0-$CGEF 
$C0FG-$C0FF 



Peripheral-Card ROM Space 

One 256-byte page of memory space is allocated to each accessory card. 
This space is normally used for read-only memory (ROM or PROM) on the 
card with driver programs that control the operation of the peripheral 
device connected to the card. 

The page of memory allocated to each expansion slot begins at location 
$CnOO, where n is the slot number, as shown in Table 6-2 and Figure 6-3. 
Whenever the Apple lie addresses one of the 256 ROM memory locations 
allocated to a particular slot, the signal on pin 1 of that slot, called I/O 
SELECT', switches to the active (low) state. This signal enables the ROM or 
PROM devices on the card, and the eight low-order address lines determine 
which of the 256 memory locations is being accessed. 



Peripheral-Card Memory Spaces 



is: 



Table 6-2. Peripheral-Card ROM Memory Locations Enabled by I/O SELECT' 



Slot 


Locations 


Slot 


Location 


1 


$C100-$C1FF 


5 


$C500-$C5FF 


2 


$C200-$C2FF 


6 


$C600-$C6FF 


3 


$C300-$C3FF 


7 


$C700-$C7FF 


4 


$C400-$C4FF 







See the section "I/O Programming 
Suggestions" later in this chapter. 



Important! 



Expansion ROM Space 

In addition to the small areas of ROM memory allocated to each expansion 
slot, peripheral cards can use the 2K-byte memory space from $C800 to 
$CFFF for larger programs in ROM or PROM. This memory space is called 
expansion ROM space. (See the memory map in Figure 6-3). Besides being 
larger, the expansion ROM memory space is always at the same locations 
regardless of which slot is occupied by the card, making programs that 
occupy this memory space easier to write. 

This memory space is available to any peripheral card that needs it. More 
than one peripheral card can have expansion ROM on it, but only one of 
them can be active at a time. 

Each peripheral card that uses expansion ROM must have a circuit on it to 
enable the ROM. The circuit does this by a two-stage process: first, it sets a 
flip-flop when the I/O SELECT" signal, pin 1 on the slot, becomes active 
(low); second, it enables the expansion ROM devices when the I/O 
STROBE' signal, pin 20 on the slot, becomes active (low). Figure 6-1 shows 
a typical ROM-enable circuit. 

The I/O SELECT' signal on a particular slot becomes active whenever the 
Apple He's microprocessor addresses a location in the 256-byte ROM address 
space allocated to that slot. The I/O STROBE' signal on all of the expansion 
slots becomes active (low) when the microprocessor addresses a location in 
the expansion-ROM memory space, SC800-SCFFF. The I/O STROBE" signal 
is used to enable the expansion-ROM devices on a peripheral card. (See 
Figure 6-1.) 

If there is an 80-column text card installed in the auxiliary slot, some of 
the functions normally associated with slot 3 are performed by the 
80-column text card and the built-in 80-column firmware. With the 
80-column text card installed, the I/O STROBE' signal is not available on 
slot 3, so firmware in expansion ROM on a card in slot 3 will not run, 



132 



Chapter 6: Programming for Peripheral Cards 



Figure 6-1. Expansion ROM Enable Circuit 



(j/oI^lIct 7 ) — - s 




^Address "j- 



A program on a peripheral card can get exclusive use of the expansion ROM 
memory space by referring to location SCFFF in its initialization phase. This 
location is special: all peripheral cards that use expansion ROM must 
recognize a reference to SCFFF as a signal to reset their ROM-enable 
flip-flops and disable their expansion ROMs. Of course, doing so also 
disables the expansion ROM on the card that is about to use it, but the next 
instruction in the initialization code sets the flip-flop in the expansion-ROM 
enable circuit on the card. 

A card that needs to use the expansion ROM space must first insert its slot 
address ($Cn) in $07F8 before it refers to SCFFF. This allows interrupting 
devices to reenable the card's expansion ROM after interrupt handling is 
finished. Once its slot address has been inserted in S07F8, the peripheral 
card has exclusive use of the expansion memory space and its program can 
jump directly into the expansion ROM. 

Figure 6-2. ROM Disable Address Decoding 




To RESET, ROM Enable 
Flip-Flop 



Peripheral-Card Memory Spaces 



m 



Important! 



As described earlier, the expansion-ROM disable circuit resets the enable 
flip-flop whenever the 65C02 addresses location $CFFF. To do this, the 
peripheral card must detect the presence of $CFFF on the address bus. You 
can use the I/O STROBE' signal for part of the address decoding, since it is 
active for addresses from $C800 through $GFFF. If you can afford to 
sacrifice some ROM space, you can simplify the address decoding even 
further and save circuitry on the card. For example, if you give up the last 
256 bytes of expansion ROM space, your disable circuit only needs to detect 
addresses of the form $CFxx, and you can use the minimal disable-decoding 
circuitry shown in Figure 6-2. 

Applesoft addresses two locations in the SCFxx space, thereby resetting 
the enable flip-flop. If your peripheral device is going to be used with 
Applesoft programs, you must either use the full address decoding or else 
enable the expansion ROM each time it is needed. 



Peripheral-Card RAM Space 

There are 56 bytes of main memory allocated to the peripheral cards, eight 
bytes per card, as shown in Table 6-3. These 56 locations are actually in the 
RAM memory reserved for the text and low-resolution graphics displays, 
but these particular locations are not displayed on the screen and their 
contents are not changed by the built-in output routine COUT1. Programs in 
ROM on peripheral cards use these locations for temporary data storage. 



Table 6-3. Peripheral-Card RAM Memory Locations 



Base 
Address 


1 


2 


Slot Numbei 
3* 4 


6 


6 


7 


$0478 


$0479 


S047A 


$047B* 


$047C 


$047D 


S047E 


S047F 


$04F8 


$04F9 


$04FA 


$04FB* 


$04FC 


$04FD 


$04FE 


S04FF 


$0578 


$0579 


$057A 


S057B* 


$057C 


$057D 


S057E 


$057F 


S05F8 


I05F9 


$05FA 


S05FB* 


I05FC 


$05FD 


S05FE 


$05FF 


$0678 


$0679 


$067A 


S067B* 


$067C 


S067D 


$067E 


$067F 


S06F8 


$06F9 


I06FA 


$Q6FB* 


S06FC 


$06FD 


$06FE 


$06FF 


$0778 


$0779 


$077A 


$077B* 


S077C 


$077D 


$077E 


$077F 


S07F8 


$07F9 


S07FA 


S07FB* 


$07FC 


$07FD 


$07FE 


S07FF 



* If there is a card in the auxiliary slot, it takes over these locations. 
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▲Warning 



A program on a peripheral card can use the eight base addresses shown in 
the table to access the eight RAM locations allocated for its use, as shown in 
the next section, "I/O Programming Suggestions." 

The Apple He firmware sets the value of S04FB to $FF on a reset, even if 
there is no 80-column card installed. 



I/O Programming Suggestions 



Important! 



A program in ROM on a peripheral card should work no matter which slot 
the card occupies. If the program includes a jump to an absolute location in 
one of the 256-byte memory spaces, then the card will work only when it is 
plugged into the slot that uses that memory space. If you are writing the 
program for a peripheral card that will be used by many people, you should 
avoid placing such a restriction on the use of the card. 

To function properly no matter which slot a peripheral card is installed 
in, the program in the card's 256-byte memory space must not make any 
absolute references to itself. Instead of using jump instructions, you 
should force conditions on branch instructions, which use relative 
addressing. 

The first thing a peripheral -card used as an I/O device must do when called 
is to save the contents of the Apple lie's microprocessor's registers. 
(Peripheral cards not being used as I/O devices do not need to save the 
registers.) The device should save the register's contents on the stack, and 
restore them just before returning control to the calling program. If there is 
RAM on the peripheral card, the information may be stored there. 

Most single-character I/O is done via the microprocessor's accumulator. A 
character being output through your subroutine will be in the accumulator 
with its high bit set when your subroutine is called. Likewise, if your 
subroutine is performing character input, it must leave the character in the 
accumulator with its high bit set when it returns to the calling program. 
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Finding the Slot Number With ROM Switched In 

The memory addresses used by a program on a peripheral card differ 
depending on which expansion slot the card is installed in. Before it can 
refer to any of those addresses, the program must somehow determine the 
correct slot number. One way to do this is to execute a JSR (jump to 
subroutine) to a location with an RTS (return from subroutine) instruction 
in it, and then derive the slot number from the return address saved on the 
stack, as shown in the following example. 



PHP 




save status 


SEI 




inhibit interrupts 


JSR 


KNGHNRTS 


-> a known RTS instruction.. 
. . . that you set up 


TSX 




get high byte of the... 


LDA 


$0100, X 


...return address from stack 


AND 


#$0F 


low-order digit is slot no. 


PLP 




restore status 



The slot number can now be used in addressing the memory allocated to the 
peripheral card, as shown in the next section. 



I/O Addressing 

Once your peripheral-card program has the slot number, the card can use 
the number to address the I/O locations allocated to the slot. Table 6-4 
shows how these locations are related to sixteen base addresses starting 
with $C080, Notice that the difference between the base address and the 
desired I/O location has the form $n0, where n is the slot number. Starting 
with the slot number in the accumulator, the following example computes 
this difference by four left shifts, then loads it into an index register and 
uses the base address to specify one of sixteen I/O locations. 



ASL 
ASL 
ASL 

ASL 
TAX 
LDA 



*C080,X 



get n into, 



. . .high-order nybble. . . 

... of index register. 

load from first I/O location 
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■ 



See the section "Setting Bank Switches" in 
Chapter 4 for more information. 



Selecting Your Target: You must make sure that you get an 
appropriate value into the index register when you address I/O locations 
this way. For example, starting with 1 in the accumulator, the 
instructions in the above example perform an LDA from location $C090, 
the first I/O location allocated to slot 1. If the value in the accumulator 
had been 0, the LDA would have accessed location SC080, thereby setting 
the soft switch that selects the second bank of RAM at location SD000 
and enables it for reading. 



Table 6-4. Peripheral-Card I/O Base Addresses 



Base 
Address 


I 


2 


Connector Number 
3 4 5 


6 


7 


SC080 


$C090 


$C0A0 


SCOBO 


scoco 


$C0D0 


$COE0 


ICOFO 


$C081 


$0091 


$C0A1 


$C0B1 


$0001 


$C0D1 


$C0E1 


SC0F1 


SC082 


SC092 


$C0A2 


SC0B2 


SC0C2 


SC0D2 


$C0E2 


$C0F2 


SC083 


$0093 


$C0A3 


$O0B3 


$C0C3 


SC0D3 


$CQE3 


IC0F3 


SC0S4 


SC094 


SC0A4 


SC0B4 


$C0C4 


$C0D4 


SC0E4 


$C0F4 


SC085 


SC095 


$C0A5 


SC0B5 


SC0C5 


SC0D5 


$C0E5 


$C0F5 


$0086 


$C096 


SC0A6 


IC0B6 


SC0G6 


$C0D6 


$C0E6 


$C0F6 


$0087 


$0097 


SC0A7 


SC0B7 


$0007 


$C0D7 


SC0E7 


IC0F7 


SC088 


$C098 


$C0A8 


$C0B8 


SC0C8 


$C0D8 


$C0E8 


$C0F8 


$C089 


SC099 


$C0A9 


$C0B9 


SC0C9 


$C0D9 


SC0E9 


SC0F9 


$C08A 


SC09A 


SCOAA 


$C0BA 


SCOCA 


SCODA 


SCOEA 


SCOFA 


SC08B 


$C09B 


SCOAB 


SCOBB 


$C0CB 


SCODB 


SCOEB 


$COFB 


SC08C 


$C09C 


SCOAC 


SCOBC 


$0000 


$C0DC 


SCOEC 


$COFC 


IC08D 


$C09D 


ICOAD 


SCOBD 


SCOCD 


$C0DD 


$C0ED 


$COFD 


SC08E 


$C09E 


SCOAE 


$C0BE 


SCOCE 


SCODE 


$C0EE 


$COFE 


SC08F 


$G09F 


$C0AF 


$G0BF 


SCOCF 


$C0DF 


$C0EF 


$COFF 
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RAM Addressing 

A program on a peripheral card can use the eight base addresses shown in 
Table 6-3 to access the eight RAM locations allocated for its use. The 
program does this by putting its slot number into the Y index register and 
using indexed addressing mode with the base addresses. The base 
addresses can be defined as constants because they are the same no matter 
which slot the peripheral card occupies. 

If you start with the correct slot number in the accumulator (by using the 
example shown earlier), then the following example uses all eight RAM 
locations allocated to the slot. 



TAY 






LDA 


$0478 


V 


STA 


$04F8 


v 


LDA 


$0578 


V 


STA 


$05F8 


Y 


LDA 


$0678 


Y 


STA 


$0GF8 


Y 


LDA 


$0778 


Y 


STA 


$07F8, 


Y 



▲Warning 



You must be very careful when you have your peripheral-card program 
store data at the base-address locations themselves since they are 
temporary storage locations; the RAM at those locations is used by the 
disk operating system. Always store the first byte of the ROM location of 
the expansion slot that is currently active (SCn) in location S7F8, and the 
first byte of the ROM location of the slot holding the controller card for 
the startup disk drive in location $5F8. 
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See "The Standard I/O Links" in Chapter 3. 



COUT1 and BASICOUT are described in 

Chapter 3. 



KEYIN and BASICIN are described in 
Chapter 3. 



Changing the Standard I/O Links 

There are two pairs of locations in the Apple He that are used for controlling 
character input and output. They are called the I/O links. In a Apple He 
running without a disk operating system, the I/O links normally contain the 
starting addresses of the standard input and output routines— KEYIN and 
COUT1 if the 80-column firmware is not active, BASICIN and BASICOUT if 
the 80-column is active. If a disk operating system is running, one or both of 
the links will hold the addresses of the operating system input and output 
routines. 

The link at locations $36 and $37 (decimal 54 and 55) is called CSW, for 
character output switch. Individually, location $36 is called CSWL (CSW 
Low) and location $37 is called CSWH (CSW High). CSW holds the starting 
address of the subroutine the Apple He is currently using for 
single-character output. This address is normally $FDF0, the address of 
routine C0UT1, or $0307, the address of BASICOUT. 

When you issue a PR#n From BASIC or an n | control H ~p1 from the 
Monitor, the Apple He changes this link address to the first address in the 
ROM memory space allocated to slot number n. That address has the form 
$CnOO. Subsequent calls for character output, are thus transferred to the 
program on the peripheral card. That program can use the instruction 
sequences given above to find its slot number and use the I/O and RAM 
locations allocated to it. When it is finished, the program can execute an 
RTS (return from subroutine) instruction to return control to the calling 
program, or jump to the output routine COUT1 at location $FDF0 to display 
the output character (which must be in the accumulator) on the screen, 
then let COUT1 return to the calling program. 

A similar link at locations $38 and S39 (decimal 56 and 57) is called KSW, 
for keyboard input switch, Individually, location $38 is called KSWL (for 
KSW low) and location $39 is called KSWH (KSW high). KSW holds the 
starting address of the routine currently being used for single-character 
input. This address is normally $FD1B, the starting address of KEYIN, or 
$C305, the address of BASICIN. 
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I3P 



Important! 

See the ProDOS Technical Reference 
Manual for more about using link 
addresses. 



Refer to the section on input and output 
link registers in the DOS Programmer's 
Manual and the ProDOS Technical 
Reference Manual for further details. 



When you issue an IN#n command from BASIC or an n | control H kI from 
the Monitor, the Apple lie changes this link address to $CnOO, the beginning 
of the ROM memory space that is allocated to slot number n. Subsequent 
calls for character input are thus transferred to the program on the 
accessory card. That program can use the instruction sequences given 
above to find its slot number and use the I/O and RAM locations allocated 
to it. The program should put the input character, with its high bit set, into 
the accumulator and execute an RTS instruction to return control to the 
program that requested input. 

When a disk operating system (ProDOS or DOS 3.3) is running, one or both 
of the standard I/O links hold addresses of the operating system's input and 
output routines. The operating system has internal locations that hold the 
addresses of the character input and output routines that are currently 
active. 

If a program that is running with ProDOS or DOS 3.3 changes the 
standard link addresses, either directly or via IN# and PR# commands, 
the operating system is disconnected. 

To avoid disconnecting the operating system each time a BASIC program 
initiates I/O to a slot, it should use either an IN# or a PR# command from 
inside a PRINT statement that starts with a ControhD character. For 
assembly-language programs, there is a DOS 3.3 subroutine call to use when 
changing the link addresses. After changing CSW or KSW, the program calls 
this subroutine at location $03EA (decimal 1002). The subroutine transfers 
the link address to a location inside the operating system and then restores 
the operating system address in the standard link location. 



Other Uses of I/O Memory Space 



The portion of memory space from location SC000 through $CFFF (decimal 
49152 through 53247) is normally allocated to I/O and program memory on 
the peripheral cards, but there are two other functions that also use this 
memory space: the built-in self-test firmware and the 80-column display 
firmware. The soft switches that control the allocation of this memory 
space are described in the next section. 
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Figure 6-3. I/O Memory Map 



CFFF 



C800 
C70O 
C60O 
C500 
C40O 
C300 
C200 
C100 
COOO 



Peripheral 
Expansion 
ROM 



Internal 
ROM and 
Peripheral 
Expansion ROM 



Slot 7 ROM 



Slot 6 ROM 



Slot 5 ROM 



Slot 4 ROM 



Slot 3 ROM 



Internal ROM 



Slot 2 ROM 



Slot. 1 ROM 



Internal 
ROM 



Internal Soft Switches and Peripheral I/O 



Switching I/O Memory 

The built-in firmware uses two soft switches to control the allocation of the 
I/O memory space from SCOOO to $CFFF. The locations of these soft 
switches, SLOTCXROM and SLOTC3ROM, are given in Table 6-5. 

Note: Like the display switches described in Chapter 2, these soft 
switches share their locations with the keyboard data and strobe 
functions. The switches are activated only by writing, and the states can 
be determined only by reading, as indicated in Table 6-5. 
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Table 6-5. I/O Memory Switches 







Location 






Name 


Function 


Hex 


Decimal 


Notes 


SLOTC3ROM 


Slot ROM at $0300 


SCOOB 


49163 


-16373 


Write 




Internal ROM at SC300 


SCOOA 


49162 


-16374 


Write 




Read SL0TC3R0M switch 


SC017 


49175 


16361 


Read 


SLOTCXROM 


Slot ROM at $0x00 


SC006 


49159 


-16377 


Write 




Internal ROM at. SCxOO 


SCOOT 


49158 


-16378 


Write 




Read SLOTCXROM switch 


$0015 


49173 


-16363 


Read 



When SLOTC3ROM is on, the 256-byte ROM area at SC300 is available to a 
peripheral card in slot 3, which is the slot normally used for a terminal 
interface. If a card is installed in the auxiliary slot when you turn on the 
power or reset the Apple He, the SLOT3ROM switch is turned off. Turning 
SLOTC3ROM off disables peripheral-card ROM in slot. 3 and enables the 
built-in 80-column firmware, as shown in Figure 6-3. The 80-column 
firmware is assigned to slot-3 address space because slot 3 is normally used 
with a terminal interface, so the built-in firmware will work with programs 
that use slot 3 this way. 

The bus and I/O signals are always available to a peripheral card in slot 3, 
even when the 80-column hardware and firmware are operating. Thus it is 
always possible to use this slot for any I/O peripheral that does not have 
built-in firmware. 

When SLOTCXROM is active (high), the I/O memory space from SC100 to 
SC7FF is allocated to the expansion slots, as described previously, Setting 
SLOTCXROM inactive (low) disables the peripheral-card ROM and selects 
built-in ROM in all of the I/O memory space except the part from $C0O0 to 
$C0FF (used for soft switches and data I/O), as showm in Figure 6-3. In 
addition to the 80-column firmware at $C300 and $C800, the built-in ROM 
includes firmware that performs the self test of the Apple He's hardware. 

Note: Setting SLOTCXROM low enables built-in ROM in all of the I/O 
memory space (except the soft-switch area), including the SC300 space, 
which contains the 80-column firmware. 
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Developing Cards for Slot 3 



Original He 



In the original Apple He firmware, the internal slot 3 firmware was 
always switched in if there was an 80-column card (either IK or 64K) in 
the auxiliary slot. This means that peripheral cards with their own ROM 
were effectively switched out of slot 3 when the system was turned on. 

With the enhanced Apple lie Monitor ROM, the rules are different. A 
peripheral card in slot 3 is now switched in when the system is started up or 
when | reset | is pressed 'if the card's ROM has the following ID bytes: 

$0305 = $38 
$0307 = $18 

The enhanced Apple He firmware requires that interrupt code be present in 
the SC3 page (either external or internal). A peripheral card in slot 3 must 
have the following code to support interrupts, After this segment, the code 
continues execution in the internal ROM at $G400. 



*C3F4 



IRQDQNE 


STA 


*C081 




JMP 


IFC7A 




IRO 






BIT 


$cnis 




STA 


tC007 



■,Read ROM, write RAM 

;Jump to *F8 ROM 



;slot or internal ROM 
;force in internal ROM 



For more information about the SC300 
firmware, see the Monitor ROM listing in 
Appendix I of this manual. Especially note 
the portion from SC300 through $C420. 



When programming for cards in slot 3; 

□ You must support the AUXMOVE and XFER routines at $0312 and 
$0314. 

□ Don't use unpublished entry points into the internal SCnOO firmware, 
because there is no guarantee that they will stay the same. 

□ If your peripheral card is a character I/O device, you must follow the 
Pascal 1.1 firmware protocol, described in the next section. 
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Pascal 1.1 Firmware Protocol 



The Pascal 1.1 firmware protocol was originally developed to be used with 
Apple Pascal 1.1 programs. The protocol is followed by all succeeding 
versions of Apple II Pascal, and can be used by programmers using other 
languages as well. 

The Pascal 1.1 firmware protocol provides Apple lie programmers with 

□ a standard way to uniquely identify new peripheral cards 

d a standard way to address the firmware routines in peripheral cards. 



Device Identification 

The Pascal 1.1 firmware protocol uses four bytes near the beginning of the 
peripheral card's firmware to identify the peripheral card. 

Address Value 

$Cs05 $38 (like the old Apple II Serial Interface Card) 

SCsOT $18 (like the old Apple II Serial Interface Card) 

SCsOB $01 (the generic signature of new cards) 

SCsOC Sci (the device signature) 

The first hexadecimal digit, c, of the device signature byte identifies the 
device class and the second hexadecimal digit, i, of the device signature 
byte is a unique identifier for the card, used by some manufacturers for 
their cards. Table 6-6 shows the device class assignments. 

Table 6-6. Peripheral-Card Device-Class Assignment 



Digit 


Device Class 


$0 


Reserved 


11 


Printer 


*■> 


Joystick or other X-Y input device 


$3 


Serial or parallel I/O card 


$4 


Modem 


$5 


Sound or speech device 


$6 


Clock 


$7 


Mass storage device 


ss 


80-colunin card 


$9 


Network or bus interface 


SA 


Special purpose (none of the above) 


$B-F 


Reserved for future expansion 
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For example, the Apple II Super Serial Card has a device signature of $31 : 
the 3 signifies that it is a serial or parallel I/O card, and the 1 is the 
low-order digit supplied by Apple Technical Support. 

Although version 1.1 of Pascal ignores the device signature, applications 
programs can use them to identify specific devices. 



I/O Routine Entry Points 

Indirect calls to the firmware in a peripheral card are done through a 
branch table in the card's firmware. The branch table of I/O routine entry 
points is located near the beginning of the CsOO address space (s being the 
slot number where the peripheral card is installed). 

The branch table locations that Pascal 1.1 firmware protocol uses are as 
follows: 

Address Contains 

$CsOD Initialization routine offset (required) 

$CsOE Read routine offset (required) 

$CsOF Write routine offset (required) 

$CslO Status routine offset (required) 

$Csl 1 $00 if optional offsets follow; non-zero if not 

$Csl2 Control routine offset (optional) 

$Csl3 Interrupt handling routine offset (optional) 

Notice that $Csl 1 contains $00 only if the control and interrupt handling 
routines are supported by the firmware, (For example, the SSC does not 
support these two routines, and so location SCsll contains a non-zero 
firmware instruction.) Apple II Pascal 1.0 and 1.1 do not support control and 
interrupt requests, but such requests are implemented in Pascal 1.2 and 
later versions and in ProDOS. 
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Table 6-7 gives the entry point addresses and the contents of the 65C02 
registers on entry to and on exit from Pascal 1.1 I/O routines. 

Table 6-7. I/O Routine Offsets and Registers Under Pascal 1.1 Protocol 



Addr. 


Offset for 


X Register 


Y Register 


A Register 


SCsOD 


Initialization 
On entry 
On exit 


$Cs 
Error code 


SsO 
(unchanged) 


(unchanged) 


ICsOE 


Read 
On entry 
On exit 


$Cs 
Error code 


$s0 
(unchanged) 


Character read 


$CsOF 


Write 
On entry 
On exit 


$Cs 
Error code 


$50 

(unchanged) 


Char, to write 
(unchanged) 


$Csio 


Status 
On entry 
On exit 


SCs 
Error code 


SsO 
(changed) 


Request (0 or 1) 
(unchanged) 



For more about interrupt support in 
ProDOS, see the ProDOS Technical 
Reference Manual. 

For information about interrupt handling 
with Apple Pascal 1.2, see the Device mid 
Interrupt Support Tools Manual which 
is part of the Apple II Device Support Tools 
package (A2WQ014). 



Interrupts on the Enhanced Apple lie 

The original Apple He offered little firmware support for interrupts. The 
enhanced Apple He's firmware provides improved interrupt support, very 
much like the Apple He's interrupt support. Neither machine disables 
interrupts for extended periods. 

Interrupts work on enhanced Apple lie systems with an installed 80-column 
text card (either IK or 64K) or a peripheral card with interrupt-handling 
ROM in slot 3. Interrupts are easiest to use with ProDOS and Pascal 1.2 
because they have interrupt support, built in. DOS 3.3 has no built-in 
interrupt support. 

The new interrupt handler operates like the Apple lie interrupt handler, 
using the same memory locations and operating protocols. The main 
purpose of the interrupt handler is to support interrupts in any memory 
configuration. This is done by saving the machine's state at the time of the 
interrupt, placing the Apple in a standard memory configuration before 
calling your program's interrupt handler, then restoring the original state 
when your program's interrupt handler is finished. 
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What Is an Interrupt? 

An interrupt is a hardware signal that tells the computer to stop what it is 
currently doing and devote its attention to a more important task. Print 
spooling and mouse handling are examples of interrupt use, things that 
don't take up all the time available to the system, but that should be taken 
care of promptly to be most useful. 

For example, the Apple He mouse can send an interrupt to the computer 
every time it moves. If you handle that interrupt promptly, the mouse 
pointer's movement on the screen will be smooth instead of jerky and 
uneven. 

Interrupt priority is handled by a daisy-chain arrangement using two pins, 
INT IN and INT OUT, on each peripheral-card slot. As described in 
Chapter 7, each peripheral card breaks the chain when it makes an 
interrupt request. On peripheral cards that, don't use interrupts, these pins 
should be connected together. 

The daisy chain gives priority to the peripheral card in slot 7: if this card 
opens the connection between INT IN and INT OUT, or if there is no card in 
this slot, interrupt requests from cards in slots 1 through 6 can't get 
through. Similarly, slot 6 controls interrupt requests (IRQ) from slots 1 
through 5, and so on down the line. 

When the IRQ' line on the Apple lie's microprocessor is activated (pulled 
low), the microprocessor transfers control through the vector in locations 
$FFFE-$FFFF. This vector is the address of the Monitor's interrupt handler, 
which determines whether the request is due to an external IRQ or a BRK 
instruction and transfers control to the appropriate routine via the vectors 
stored in memory page 3. The BRK vector is in locations $03F0-$03F1 and 
ProDOS uses the IRQ vector in locations $03FE-$03FF. (See Table 4-11.) 
The Monitor normally stores the address of its reset routine in the IRQ 
vector; you should substitute the address of your program's 
interrupt-handling routine. 

Apple Pascal doesn't use the BRK vector at $03F0-$03F1, but it does use the 
IRQ vector at $03FE-$03FF. 
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Interrupts on Apple II Series Computers 



Original He 



Original lie 



The interrupt handler built in to the enhanced Apple He's firmware saves 
the contents of the accumulator on the stack. (The original Apple He saves 
the contents of the accumulator at location $45.) DOS 3.3, as well as the 
Monitor, rely on the integrity of location $45, so this change lets both 
DOS 3.3 and the Monitor continue to work with active interrupts on the 
enhanced Apple He. 

Since the built-in interrupt handler on the original Apple He uses location 
$45 to save the contents of the accumulator, the operating system fails 
when an interrupt occurs under DOS 3.3 on the original Apple He. 

If you want to write programs that use interrupts while running on the 
original Apple lie, Apple II Plus, or Apple II, you must use either ProDOS 
or Apple II Pascal 1.2 (or later versions). Both these operating systems 
give you full interrupt support, even though these versions of the Apple II 
don't include interrupt support in their firmware. (Versions of Pascal 
before 1.2 do not work with interrupts enabled on an original Apple He.) 

Some other manufacturer's hardware, such as co-processor cards, don't 
work properly in an interrupting environment. If you are trying to develop 
an application and encounter this problem, check with the manufacturer of 
the card to see if a later version of the hardware or its software will operate 
properly with interrupts active. You may not be able to use interrupts if an 
interrupt tolerant version isn't available. 

Interrupts are effective only if they are enabled most of the time. Interrupts 
that occur while interrupts are disabled will not be serviced. 

Pascal, DOS 3.3, and ProDOS turn off interrupts while performing disk 
operations because of the critical timing of disk read and write operations. 
Some peripheral cards used in the Apple He disable interrupts while reading 
and writing. 

Although the enhanced Apple He firmware never disables interrupts 
during screen handling, the original Apple lie periodically turns 
interrupts off while doing 80-column screen operations. The effect is most 
noticeable while the screen is scrolling. 
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Important! 



Don't use PR#6 to restart, your Apple He while running ProDOS with 
interrupts enabled since PR#6 doesn't disable interrupts. If you try it, 
ProDOS will fail as it starts up since its interrupt handlers aren't yet set 
up, If you have to restart, use | control H reset I , or make sure that your 
program disables interrupts before it ends. 



Important! 



See the section "Developing Cards for 
Slot 3" earlier in this chapter. 



Rules of the Interrupt Handler 

Unlike the Apple He, the enhanced Apple He's interrupt handling firmware 
is not always switched in. Here are the reasons why this is so and the 
implications that necessarily follow. 

There is no part of memory in the Apple He that is always switched in. 
Thus, there is no location for an interrupt handler that works for all 
memory configurations. However, the $C3 page of firmware is present on all 
systems that have 80-column text cards in their auxiliary slots, so it was 
selected as the starting location of the built-in interrupt handling routine. 

There are two factors that determine if the $C3 firmware is switched in and 
therefore whether or not interrupts will be usable: 

d Is there an 80-column text card in the auxiliary slot? 
d If not, is there a peripheral card in slot 3 with built-in ROM with bytes 
$C305 = $38 and SC307 = $18? 

The Apple He's memory is switched according to the following rules at both 
powerup and reset: 

d If there is a ROM card in slot 3, but no text card in the auxiliary slot, the 
firmware on the ROM card is switched in. This is necessary for Pascal to 
work. 

□ If there is a text card in the auxiliary slot, but no ROM card in slot 3, the 

internal $C3 firmware is switched in. 
d If there is both a text card in the auxiliary slot and a ROM card in slot 3, 

the firmware on the ROM card is switched in. 

These rules mean that systems without 80-column text cards in the 
auxiliary slot do not have their internal $C3 firmware switched in. Such 
systems cannot handle interrupts or breaks (the software equivalent of 
interrupts). An application program must swap in the $C3 firmware both 
on initialization and after reset to make interrupts function properly on 
such a machine configuration, (ProDOS versions 1.1 and later do this for 
you during startup.) 
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Another implication of the decision to have interrupt code in the $C3 page 
affects the shared $C800 space in the Apple He. When the SC3 page is 
referenced, the He hardware automatically switches in its own SC800 
space. When the interrupt handler finishes, it restores the $C800 space to 
the original owner using MSLOT (S07F8), This means that it is very 
important for a peripheral card to place its slot address in MSLOT to support 
interrupts while code is being executed in its $C800 space. 



Interrupt Handling on the 65C02 and 6502 

There are three possible conditions that will allow interrupts on the 65C02 
and 6502: 

d The IRQ line on the microprocessor is pulled low after a CLI instruction 
has been used (interrupts are not masked). This is the standard 
technique that devices use when they need immediate attention. 

d The microprocessor executes a break instruction (BRK = opcode $00). 

□ A non-maskable interrupt (NMI) occurs. The microprocessor services 
this interrupt whether or not the CLI instruction has been used. An NMI 
is completely independent of the interrupts discussed in this manual. 

The microprocessor saves the current program counter and status byte on 
the stack when an interrupt occurs and then jumps to the routine whose 
address is stored in §FFFE and $FFFF. The sequence of operations 
performed by the microprocessor is as follows: 

1. It finishes executing the current instruction if an IRQ is encountered. (If 
a BRK instruction is encountered, the current instruction is already 
finished.) 

2. It pushes the high byte of the program counter onto the stack. 

3. It pushes the low byte of the program counter onto the stack. 

4. It pushes the processor status byte onto the stack. 

5. It executes a JMP ($FFFE) instruction. 

The Interrupt Vector at $FFFE 

Three separate regions of memory contain address $FFFE in an Apple He 
with an Extended 80-Column Text Card: the built-in ROM, the 
bank-switched memory in main RAM, and the bank-switched memory in 
auxiliary RAM. The vector at SFFFE in the ROM points to the built-in 
interrupt handling routine. You must copy the ROM's interrupt vector to the 
other banks yourself if you plan to use interrupts with the bank-switched 
memory switched in. 
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Interrupt handler installation is described 
in the ProDOS Technical Reference 
Manual and the Device and Interrupt 
Support Tools Manual, which is part of 
the Apple He Device Support Tools package 
(A2WQ014). 



The Built-in Interrupt Handler 

The enhanced Apple lie's built-in interrupt handler records the computer's 
current memory configuration, then sets the computer's memory 
configuration to a standard state so that your program's interrupt handier 
always begins running in the same memory configuration. 

Next the built-in interrupt handler checks to see if the interrupt was caused 
by a break instruction, and handles it as just described under "Interrupt 
Handling on the 65C02 and 6502." If it was not a break, it passes control to 
the interrupt handling routine whose address is stored at $3FE and $3FF of 
main memory. Normally, that would be the operating system's interrupt 
handler, unless you have installed one of your own. 

After your program's interrupt handler returns (with an RT1), the built-in 
interrupt handler restores the memory configuration, and then does another 
RT1 to return to where it was when the interrupt occurred. Figure 6-4 
illustrates this entire process. Each of these steps is explained later in this 
chapter. 



Figure 6-4. Interrupt-Handling Sequence 
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Important! 



Saving the Apple He's Memory Configuration 

The built-in interrupt handler saves the Apple He's memory configuration 
and then sets it to a known state according to these rules: 

□ Text Page 1 is switched in (PAGE2 off) so that main screen holes are 
accessible if 80STORE and PAGE2 are on. 

□ Main memory is switched in for reading (RAMRD off). 

□ Main memory is switched in for wilting (RAMWRT off). 

□ $D000-$FFFF ROM is switched in for reading (RDLCRAM off). 

□ Main stack and zero page are switched in (ALTZP off). 

d The auxiliary stack pointer is preserved, and the main stack pointer is 
restored. (See the next section, "Managing Main and Auxiliary Stacks.") 

Because main memory is switched in, all memory addresses used later in 
this chapter are in main memory unless otherwise specified. 



Managing Main and Auxiliary Stacks 

Apple has adopted a convention that allows the Apple He to be run with two 
separate stack pointers since the Apple He with an Extended 80-Column 
Text Card has two stack pages. Two bytes in the auxiliary stack page are 
used as storage for inactive stack pointers: $0100 for the main stack pointer 
when the auxiliary stack is active, and $0101 for the auxiliary stack pointer 
when the main stack is active, 

When a program using interrupts switches in the auxiliary stack for the 
first time, it must place the value of the main stack pointer at SO 100 (in the 
auxiliary stack) and initialize the auxiliary stack pointer to $FF (the top of 
the stack). When it subsequently switches from one stack to the other, it 
must save the current stack pointer before loading the pointer for the other 
stack. 

The current stack pointer is stored at $0101, and the main stack pointer is 
retrieved from $0100 when an interrupt occurs while the auxiliary stack is 
switched in. Then the main stack is switched in for use. The stack pointer 
is restored to its original value after the interrupt has been handled. 
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Important! 



The built-in XFER routine does not support this procedure. If you are 
using XFER to swap stacks, you must use code like the following to set up 
the stack pointers and stack. 



* This example transfers control from a code segment running 

* using the main stack to one running using the aux stack. 



1 XFERALT PHP 




2 


PLA 




3 


SEI 




A 


TSX 




5 


STA 


SETALTZP 


6 


STX 


$100 


7 


LDX 


$101 


S 


TXS 




9 


PHA 




10 


PLP 




1 1 


LDA 


#DESTL 


12 


STA 


$3ED 


13 


LDA 


'DESTH 


14 


STA 


$3EE 


15 


SEC/CLC 


16 


BIT 


RTS 


17 


JMP 


XFER 



jpreserve interrupt status in A 

;disable interrupts 

;save main stack pointer at $108 

;and swap zero pages 

; now restore aux stack pointer 

;and interrupt status 

;set destination address 



;set direction of transfer 

;V»1 for alt zero page (RTS=$60> 

;do transfer 



To transfer control the other direction, change the following lines 



5 
6 
7 

*6 



STX $101 
LDX $100 
STA SETSTDZP 

CLV 



;V=0 for main zp 
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The User's Interrupt Handler at $3FE 

If your program has an interrupt handler, it must place the entry address of 
that handler at S03FE. After it sets the machine to a standard state, the lie's 
interna] interrupt handler transfers control to the routine whose address is 
in the vector at $03FE. 

It is very important for a peripheral card to place its slot address in MSLOT 
to support interrupts whenever it is executing code in its $C800 space. 
Whenever the $C3 page is referenced, the He automatically switches in its 
own $C800 ROM space. When the interrupt handler finishes, it restores the 
$C800 space to the original owner using MSLOT ($07F8). 

▲Warning Be careful to install interrupt handlers according to the rules of the 
operating system that you are using. Placing the address of your 
program's interrupt handler at S03FE disconnects the operating system's 
interrupt handler. 

The S03FE interrupt handler must do these things: 

1. Verify that the interrupt came from the expected source. 

2. Handle the interrupt as desired, 

3. Clear the appropriate interrupt soft switch. 

4. Return with an RTI. 

Here are some things to remember if you are dealing with programs that 
must run in an interrupt enviroment: 

□ There is no guaranteed maximum response time for interrupts because 
the system may be doing a disk operation that lasts for several seconds. 

□ Once the built-in interrupt handler is called, it takes at least 150 to 
200 microseconds for it to call your interrupt handling routine. After your 
routine returns, it takes 40 to 140 microseconds to restore memory and 
return to the interrupted program. 

□ If memory is in the standard state when the interrupt occurs, the total 
overhead for interrupt processing is about 150 microseconds less than if 
memory is in the worst state. (The worst state is one that requires the 
most work to set up for: 80STORE and PAGE2 on; auxiliary memory- 
switched in for reading and writing; bank-switched memory page 2 in the 
auxiliary bank switched in for reading and writing; and internal $Cn00 
ROM switched in). 

d Interrupt overhead will be greater if your interrupt handler is installed 
through an operating system's interrupt dispatcher. The length of delay 
depends on the operating system, and on whether the operating system 
dispatches the interrupt to other routines before calling yours. 
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Handling Break Instructions 

The 65C02 treats a break instruction (BRK, opcode $00) just like a hardware 
interrupt. After the interrupt handler sets the memory configuration, it 
checks to see if the interrupt was caused by a break (bit 4 of the status byte 
is set), and if it was, jumps to a break handling routine. This routine saves 
the state of the computer at the time of the break as shown in Table 6-8. 

Table 6-8. BRK Handler Information 

Information Location 

Program counter (low byte) $3A 

Program counter (high byte) $ 3B 

Encoded memory state $44 

Accumulator $45 

X register $46 

Y register $47 

Status register $48 

Finally the break routine jumps to the routine whose address is stored at 
$3F0 and $3F1. 

The encoded memory state in location $44 is interpreted as shown in 
Table 6-9. 



Table 6-9. Memory Configuration Information 

Bit 7=1 if auxiliary zero page and auxiliary stack are switched in 

Bit 6 = 1 if 80STORE and PAGE2 both on 

Bit 5=1 if auxiliary RAM switched in for reading 

Bit 4=1 if auxiliary RAM switched in for writing 

Bit 3=1 if bank-switched RAM being read 

Bit 2 = 1 if bank-switched $DO0O Page 1 switched in and RAMREAD set 

Bit 1 = 1 if bank-switched $DO0O Page 2 switched in and RAMREAD set 

Bit. 0=1 if internal Cs ROM was switched in (He only) 
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Interrupt Differences: Apple lie Versus Apple lie 

If you are writing software for both the Apple He and the Apple lie, you 
should know that there are several important differences between the 
interrupts on the enhanced Apple He and those on the Apple He. They are 

d In the He ROM, SFFFE points to $C803; in the He ROM, to $C3FA. To 
ensure that the proper interrupt vectors are placed into the Language 
Card RAM space, always copy them to the RAM from the ROM. (When 
you initialize built-in devices on the lie, these vectors are automatically 
updated). 

□ There is no shared $C800 ROM in the lie. Peripheral cards share this 
space in the lie. Thus it is crucial that the slot address of the peripheral 
card using the SC800 space is stored in MSLOT ($07F8). When the 
interrupt handler goes to the internal $C3 space, the He hardware 
switches in its own SC800 space. When the interrupt handler finishes, it 
restores the SC800 space to the slot whose address is in MSLOT. 

a The lie SC800 space is always switched in. The enhanced lie's interrupt 
handler preserves the state of the SC800-space switch and then switches 
in the slot I/O space. This means that when restoring the state of the 
system using the value placed in location $44, break handling routines must 
restore one more value on the Apple lie than on the Apple He. 
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Chapter 7 



Hardware Implementation 




m 



Most of this manual describes functions— what the Apple He does. This 
chapter, on the other hand, describes objects: the pieces of hardware the 
Apple He uses to carry out its functions. If you are designing a piece of 
peripheral hardware to attach to the Apple He, or if you just want to know 
more about how the Apple He is built, you should study this chapter. 



Environmental Specifications 



The Apple He is quite sturdy when used in the way it was intended. 
Table 7-1 defines the conditions under which the Apple lie is designed to 
function properly. 



Table 7-1. Summary of Environmental Specifications 



Operating Temperature: 
Relative Humidity: 
Line Voltage: 



0°to45 C(30 toll5°F) 
5% to 85% 
107 to 132 VAC 



You should treat the Apple He with the same kind of care as any other 
electrical appliance. You should protect it from physical violence, such as 
hammer blows or defenestration. You should protect the mechanical 
keyboard and the electrical connectors inside the case from spilled liquids, 
especially those with dissolved contaminants, such as coffee and cola 
drinks. 

In normal operation, enough air flows through the slots in the case to keep 
the insides from getting too hot, although some of the parts inside the 
Apple He normally get rather warm to the touch. If you manage to overheat 
your Apple He, by blocking the ventilation slots in the top and bottom for 
example, the first symptom will be erratic operation. The memory devices 
in the Apple He are sensitive to heat: when they get too hot, they 
occasionally change a bit of data. The exact result depends on what kind of 
program you are running and on just which bit of memory is affected. 
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The Power Supply 



The power supply in the Apple He operates on normal household AC power 
and provides enough low-voltage electrical power for the built-in electronics 
plus a full complement of peripheral cards, including disk controller cards 
and communications interfaces. The basic specifications of the power 
supply are listed in Table 7-2. 

The Apple lie's power cord should be plugged into a three- wire 110- to 
120-volt outlet. You must connect the Apple lie to a grounded outlet or to a 
good earth ground. Also, the line voltage must be in the range given in 
Table 7-2. If you try to operate the Apple He from a power source with more 
than 140 volts, you will damage the power supply. 

Table 7-2. Power Supply Specifications 



Line voltage: 

Maximum power consumption: 

Supply voltages: 



Maximum supply currents: 



Maximum case temperature: 



107V to 132V AC 

60W continuous 
SOW intermittent* 

+5V ±3% 
+ 11.8V ±Q% 
-5.2V ± 10% 
-12V ± 10% 

+5V: 2.5A 

+ 12V: 1.5A continuous, 

2.5A intermittent* 
-5V: 250mA 
-12V: 250mA 

55° C (130° F) 



' Intermittent operation: The Apple lie can safely operate for up to twenty minutes at the 
higher load if followed by at least ten minutes at normal load. 
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A Warning 



The Apple He uses a custom-designed switching type power supply. It is 
small and lightweight, and it generates less heat than other types of power 
supplies do. 

The Apple He's power supply works by converting the AC line voltage to DC 
and using this DC voltage to power a variable-frequency oscillator. The 
oscillator drives a small transformer with many separate windings to 
produce the different voltages required. A circuit compares the voltage of 
the +5-volt supply with a reference voltage and feeds an error signal back 
to the oscillator circuit. The oscillator circuit uses the error signal to control 
the frequency of its oscillation and keep the output voltages in their normal 
ranges. 

The power supply includes circuitry to protect itself and the other 
electronic parts of the Apple lie by turning off all four supply voltages 
whenever it detects one of the following malfunctions: 

□ any supply voltage short-circuited to ground 

□ the power-supply cable disconnected 

□ any supply voltage outside the normal range 

Any time one of these malfunctions occurs, the protection circuit stops the 
oscillator, and all the output voltages drop to zero. After about half a second, 
the oscillator starts up again. If the malfunction is still occurring, the 
protection circuit stops the oscillator again. The power supply will continue 
to start and stop this way until the malfunction is corrected or the power is 
turned off. 

If you think the power supply is broken, do not attempt to repair it 
yourself. The power supply is in a sealed enclosure because some of its 
circuits are connected directly to the power line. Special equipment is 
needed to repair the power supply safely, so see your authorized Apple 
dealer for service. 
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The Power Connector 

The cable from the power supply is connected to the main circuit board by a 
six-pin connector with a strain-relief catch. The connector pins are 
identified in Table 7-3 and Figure 7-13d. 

Table 7-3. Power Connector Signal Specifications 



Pin Number 


Name 


Description 


1,2 


Ground 


Common electrical ground 


3 


+5V 


+5V from power supply 


4 


+ 12V 


+12V from power supply 


5 


-12 V 


-12V from power supply 


6 


-5V 


-5V from power supply 



The 65C02 Microprocessor 



See Appendix A for a description of the 
65C02's instruction set and electrical 
characteristics. 



The enhanced Apple He uses a 65C02 microprocessor as its central 
processing unit (CPU). The 65C02 in the Apple He runs at a clock rate of 
1.023 MHz and performs up to 500,000 eight-bit operations per second. You 
should not use the clock rate as a criterion for comparing different types of 
microprocessors. The 65C02 has a simpler instruction cycle than most other 
microprocessors and it uses instruction pipelining for faster processing. The 
speed of the 65C02 with a 1MHz clock is equivalent to other types of 
microprocessors with clock rates up to 2,5MHz. 

The 65C02 has a sixteen-bit address bus, giving it an address space of 64K 
(2 to the sixteenth power or 65536) bytes. The Apple lie uses special 
techniques to address a total of more than 64K: see the sections 
"Bank-Switched Memory" and "Auxiliary Memory and Firmware" in 
Chapter 4 and the section "Switching I/O Memory" in Chapter 6. 
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Table 7-4. 65C02 Microprocessor Specifications 



Type: 

Register Complement: 



Data Bus: 
Address Bus: 
Address Range: 
Interrupts: 

Operating Voltage: 
Power Dissipation: 



65C02 

8-bit Accumulator (A) 
8-bit Index Registers (X,Y) 
8-bit Stack Pointer (S) 
8-bit Processor Status (P) 
16-bit Program Counter (PC) 

Eight bits wide 

Sixteen bits wide 

65,536 (64K) 

IRQ (maskable) 
NMI (non-maskable) 
BRK (programmed) 

+5V(±5%) 

BmW(atlMHz) 



65C02 Timing 

The operation of the Apple He is controlled by a set of synchronous timing 
signals, sometimes called clock signals. In electronics, the word clock is 
used to identify signals that control the timing of circuit operations. The 
Apple lie doesn't contain the kind of clock you tell time by, although its 
internal tuning is accurate enough that a program running on the Apple He 
can simulate such a clock. 

The frequency of the oscillator that, generates the master timing signal is 
14.31818 MHz. Circuitry in the Apple He uses this clock signal, called 14M, 
to produce all the other timing signals. These timing signals perform two 
major tasks: controlling the computing functions, and generating the video 
display. The timing signals directly involved with the operation of the 
65G02 (and 6502 on the original version of the Apple He) are described in 
this section. Other timing signals are described in this chapter in the 
sections "RAM Addressing," "Video Display Modes," and "The Expansion 
Slots." 

The main 65C02 timing signals are listed in Table 7-5, and their 
relationships are diagrammed in Figure 7-1. The 65C02 clock signals are <j>l 
and 00, complementary signals at a frequency of 1.02273 MHz. The 
Apple He signal named 00 is equivalent to the signal called <$, in the 
hardware manual. (It isn't identical: it's a few nanoseconds early.) 
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Table 7-5. 65CQ2 Timing Signal Descriptions 



Signal 
Name 

14M 

VID7M 

00 

01 



Description 

Master oscillator, 14.318 MHz; also 80-column dot clock 
Intermediate timing signal and 40-column dot clock 

Intermediate timing signal, 2.045 MHz with asymmetrical duty 

cycle 

Phase of 65C02 clock, 1.0227 MHz; complement of 01 
Phase 1 of 65C02 clock, 1.0227 MHz; complement of 00 



Figure 7-1. 65C02 Timing Signals 
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The operations of the 65C02 are related to the clock signals in a simple way: 
address during 0l, data during 00. The 65C02 puts an address on the 
address bus during 01. This address is valid not later than 140 nanoseconds 
after 01 goes high and remains valid through all of 00. The 65C02 reads or 
writes data during 00. If the 65C02 is writing, the read/write signal is low 
during 00 and the 65C02 puts data on the data bus, The data is valid not 
later than 75 nanoseconds after 00 goes high. If the 65C02 is reading, the 
read/ write signal remains high. Data on the data bus must be valid no later 
than 50 nanoseconds before the end of 00. 



The Custom Integrated Circuits 

Most of the circuitry that controls memory and I/O addressing in the 
Apple He is in three custom integrated circuits called the Memory 
Management Unit (MMU). the Input/Output Unit (IOU), and the 
Programmed Array Logic device (PAL). The soft switches used for 
controlling the various I/O and addressing modes of the Apple lie are 
addressable flags inside the MMU and the IOU. The functions of these two 
devices are not as independent as their names suggest; working together, 
they generate all of the addressing signals, For example, the MMU generates 
the address signals for the CPU, while the IOU generates similar address 
signals for the video display. 



The Memory Management Unit 

The circuitry inside the MMU implements these soft switches, which are 
described in the indicated chapters in this manual; 

d Page 2 display (PAGE2): Chapter 2 

□ High resolution mode (HIRES): Chapter 2 

□ Store to 80-column card (80STOEE): Chapter 2 

□ Select bank 2: Chapter 4 

□ Enable bank-switched RAM: Chapter 4 

d Read auxiliary memory (RAMRD): Chapter 4 

□ Write auxiliary memory (RAMWRT): Chapter 4 

□ Auxiliary stack and zero page (ALTZP): Chapter 4 

d Slot ROM for connector #3 (SLOTC3ROM): Chapter 6 

□ Slot ROM in I/O space (SLOTCXROM): Chapter 6 
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The 64K dynamic RAMs used in the Apple He use a multiplexed address, as 
described later in this chapter in the section "Dynamic-RAM Timing." The 
MMU generates this multiplexed address for memory reading and writing 
by the 65C02 CPU. The pinouts and signal descriptions of the MMU are 
shown in Figure 7-2 and Table 7-6. 



Figure 7-2. The MMU Pinouts 



Table 7-6. The MMU Signal Descriptions 
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RA5 
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12 
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28 
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27 
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15 


26 


DMA' 


16 


25 


EN80' 


17 


24 


KBD' 


18 


23 


ROMEN2' 


19 


22 


ROMEN1' 


20 


21 



AI 

A2 

A3 

KA 

A5 

AS 

A7 

A* 

A9 

A10 

All 

A12 

A13 

A14 

A15 

+6V 

Cxxx 

RAMEN' 

R/W' 245 

MD7 



Pin 






Number 


Name 


Description 


i 


GND 


Power and signal common 


2 


A0 


65C02 address input 


3 


00 


Clock phase input 


4 


Q3 


Timing signal input 


5 


PRAS' 


Memory row-address strobe 


6-13 


RA0-RA7 


Multiplexed address output 


14 


R/W 


65C02 read-write control signal 


15 


INH' 


Inhibits main memory (tied to +5 V) 


16 


DMA' 


Controls data bus for DMA transfers 


17 


EN80' 


Enables auxiliary RAM 


18 


KBD' 


Enables keyboard data bits 0*6 


19 


ROMEN2' 


Enables ROM (tied to ROMEN1') 


20 


ROMEN1' 


Enables ROM (tied to ROMEN2') 


2! 


MD7 


State of MMU flags on data bus bit 7 


22 


RW245 


Controls 74LS245 data-bus buffer 


n 


RAMEN' 


Enables main RAM 


24 


Cxxx 


Enables peripheral-card memory 


25 


+5V 


Power 


26-40 


A15-A1 


65C02 address input 



I 
I 
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The Input/Output Unit 

The circuitry inside the Input/Output Unit (IOU) implements the following 
soft switches, all described in Chapter 2 in this manual: 

□ Page 2 display (PAGE2) 

□ High resolution mode (HIRES) 

□ Text mode (TEXT) 

□ Mixed mode (MIXED) 

a 80-column display (80COL) 

□ Text display mode select (ALTCHAR) 

□ Any-key-down 

□ Annunciators 

□ Vertical blanking (VBL) 

The 64K dynamic RAMs used in the Apple lie require a multiplexed 
address, as described later in this chapter in the section "Dynamic-RAM 
Timing." The IOU generates this multiplexed address for the data transfers 
required for display and memory refresh during clock phase 1. The way this 
address is generated is described later in this chapter in the section "Display 
Address Mapping." The pinouts and signal descriptions for the IOU are 
shown in Figure 7-3 and Table 7-7. 
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Figure 7-3. The IOU Pinouts 



Table 7-7, The IOU Signal Descriptions 
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CASSO 


7 


34 


SPKR 


8 


33 


MD7 


9 


32 


ANO 


10 


31 


AN1 


11 


30 


AN2 


12 


29 


AN3 


13 


28 


R/W 


14 
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(n.c.) 


16 


25 


RAO 


17 


24 


RA1 


18 


23 


RA2 
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HO 


Number 


Name 


SYNC' 






WNDW 


1 


GND 


CLRGAT' 


2 


GR 


RA10' 


3 


SEGA 


RA9' 






VID6 
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SEGB 


VID7 






KSTRB 






AKD 






COxx 


5 


VC 


A6 






+5V 






Q3 






00 






PRAS' 


6 


80VID' 


RA7 


; 


CASSO 


RA6 


* 


SPKR 


RA5 


9 


MD7 


RA4 


10-13 


AN0-AN3 




14 


R/W 




15 


RESET' 




16 






17-24 


RA0-RA7 




25 


PRAS' 




26 


00 




27 


Q3 




2^ 


+5V 




2:< 


A6 




V 


COxx 




31 


AKD 




32 


KSTRB 




33,34 


VIDD7.VIDD6 




35,36 


RA9'.RA10' 




37 


CLRGAT' 




38 


WNDW 




m 


SYNC 




40 


HO 



Description 

Power and signal common 

Graphics mode enable 

In text mode, works with VC (see pin 5) and SEGB 

to determine character row address 

In text mode, works with VC (see pin 5) and SEGA; 

in graphics mode, selects high-resolution when low, 

low-resolution when high 

Display vertical counter bit: in text mode, SEGA, 

SEGB and VC determine which of the eight rows of 

a character's dot pattern to display; in 

low-resolution, selects upper or lower block defined 

by a byte. 

80-column video enable 

Cassette output signal 

Speaker output signal 

Internal IOU flags for data bus (bit 7)3 

Annunciator outputs 

65C02 read-write control signal 

Power on and reset output 

Nothing is connected to this pin. 

Video refresh multiplexed RAM address (phase 1) 

Row-address strobe (phase 0) 

Master clock phase 

Intermediate timing signal 

Power 

Address bit 6 from 65C02 

I/O address enable 

Any-key-down signal 

Keyboard strobe signal 

Video display data bits 

Video display control bits 

Color-burst gate (enable) 

Display blanking signal 

Display synchronization signal 

Display horizontal timing signal (low bit of 

character counter) 
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Figure 74. The PAL Pinouts 



The PAL Device 

A Programmed Array Logic device, type PAL 16R8, generates several timing 
and control signals in the Apple He. These signals are listed in Table 7-8. 
The PAL pinouts are given in Figure 7-4. 

Table 7-8. The PAL Signal Descriptions 
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18 


HO 
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5 
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6 


15 


GR 
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14 
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13 


80VID' 
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12 
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Pin 






+5V 


Number 


Name 


Description 


PRAS' 








(n.c.) 


1 


14M 


14.31818 MHz master timing signal 


PCAS' 


2 


7M 


7.15909 MHz timing signal 


Q3 


3 


3.58M 


3.579545 MHz timing signal 


0ii 


4 


HO 


Horizontal video timing signal 


4>\ 


5 


VID7 


Video data bit 7 


VID7M 
LDPS' 
ENTMG 


6 


SEGB 


Video timing signal 


7 


GR 


Video display graphics-mode enable 




8 


RAMEN' 


RAM enable (CAS enable) 




9 


80VID' 


Enable 8Q-column display mode 




10 


GND 


Power and signal common 




11 


ENTMG 


Enable master timing 




L2 


LDPS' 


Video shift-register load enable 




L3 


V1D7M 


Video dot clock, 7 or 14 MHz 




14 


01 


Phase 1 system clock 




15 


00 


Phase system clock 




16 


Q3 


Intermediate timing and strobe signal 




17 


PCAS' 


RAM column-address strobe 




18 


N.C. 


(This pin is not used.) 




19 


PRAS' 


RAM row-address strobe 




20 


+5V 


Power 



Memory Addressing 



The Apple He's microprocessor can address 65,536 locations. The Apple He 
uses this entire address space, and then some: some areas in memory are 
used for more than one function. The following sections describe the 
memory devices used in the Apple He and the way they are addressed. 
Input and output also use portions of the memory address space; refer to the 
section "Peripheral-Card Memory Spaces" in Chapter 6 for information. 
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Figure 7-5. The 2364 ROM Pinouts 
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ROM Addressing 

In the Apple lie, the following programs are permanently stored in two type 
2364 8K by 7-bit ROMs (read-only memory): 

d Applesoft editor and interpreter 

□ System Monitor 

d 80-column display firmware 

□ self-test routines 

These two ROMs are enabled by two signals called ROMEN1 and ROMEN2. 
The ROM enabled by ROMEN1, sometimes called the Diagnostics ROM, 
occupies the memory address space from $C100 to $DFFF. The address 
space from $C300 to $C3FF and from $C800 to $CFFF contains the 
80-column display firmware. Those address spaces are normally assigned to 
ROM on a peripheral card in slot 3; for a discussion of the way the 
80-column firmware overrides the peripheral card, see the section "Other 
Uses of I/O Memory Space" in Chapter 6. The pinouts of the 2364 ROMs are 
given in Figure 7-5. 

Two other portions of the Diagnostics ROM, addressed from $C100 to $C2FF 
and from SC400 to SC7FF, contain the built-in self-test routines. These 
address spaces are normally assigned to the peripheral cards; when the 
self -test programs are running, the peripheral cards are disabled. 

The remainder of the Diagnostics ROM, addressed from $DOG0 to $DFFF, 
contains part of the Applesoft BASIC interpreter. 

The ROM enabled by ROMEN2, sometimes called the Monitor ROM, 
occupies the memory address space from SEOOO to SFFFF. This ROM 
contains the rest of the Applesoft interpreter, in the address space from 
SE000 to SEFFF, and the Monitor subroutines, from SFOO0 to SFFFF. 

The other ROMs in the Apple He are a type 2316 ROM used for the keyboard 
character decoder and a type 2333 ROM used for character sets for the video 
display. This 2333 ROM is rather large because it includes a section of 
straight-through bit-mapping for the graphics modes. This way, graphics 
display video can pass through the same circuits as text without additional 
switching circuitry. The 2316's pinout is given in Figure 7-6, and the 2333's 
pinout is given in Figure 7-7. 
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Figure 7-8. The 64K RAM Pinouts 
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RAM Addressing 

The RAM (programmable) memory in the Apple He is used both for program 
and data storage and for the video display. The areas in RAM that are used 
for the display are accessed both by the 65C02 microprocessor and by the 
video display circuits. In some computers, this dual access results in 
addressing conflicts (cycle stealing) that can cause temporary dropouts in 
the video display. This problem does not occur in the Apple He, thanks to 
the way the microprocessor and the video circuits share the memory. 

The memory circuits in the Apple lie take advantage of the two-phase 
system clock described earlier in this chapter in the section "65C02 Timing" 
to interleave the microprocessor memory accesses and the display memory 
accesses so that they never interfere with each other. The microprocessor 
reads or writes to RAM only during 00, and the display circuits read data 
only during 01. 



Dynamic-RAM Refreshment 

The image on a video display is not permanent; it fades rapidly and must be 
refreshed periodically. To refresh the video display, the Apple He reads the 
data in the active display page and sends if to the display. To prevent 
visible flicker in the display, and to conform to standard practice for 
broadcast video, the Apple He refreshes the display sixty times per second. 

The dynamic RAM devices used in the Apple lie also need a kind of refresh, 
because the data is stored in the form of electric charges which diminish 
with time and must be replenished every so often. The Apple He is designed 
so that refreshing the display also refreshes the dynamic RAMs. The next 
few paragraphs explain how this is done. 

The job of refreshing the dynamic RAM devices is minimized by the 
structure of the devices themselves. The individual data cells in each RAM 
device are arranged in a rectangular array of rows and columns. When the 
device is addressed, the part of the address that specifies a row is presented 
first, followed by the address of the column. Splitting information into parts 
that follow each other in time is called multiplexing. Since only half of the 
address is needed at one time, multiplexing the address reduces the number 
of pins needed for connecting the RAMs. 

Different manufacturers' 64K RAMs have cell arrays of either 128 rows by 
512 columns or 256 rows by 256 columns. Only the row portion of the 
address is used in refreshing the RAMs. 
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Now consider how the display is refreshed. As described later in this 
chapter in the section "The Video Counters," the display circuitry generates 
a sequence of 8,192 memory addresses in high-resolution mode; in text and 
low resolution modes, this sequence is the 1,024 display-page addresses 
repeated eight times. The display address cycles through this sequence 
60 times a second, or once every 17 milliseconds. The way the low-order 
address lines are assigned to the RAMs, the row address cycles through all 
256 possible values once every two milliseconds. (See Figure 7-9.) This 
more than satisfies the refresh requirements of the dynamic RAMs. 

Table 7-9. RAM Address Multiplexing 
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Dynamic-RAM Timing 

The Apple lie's microprocessor clock runs at a moderate speed, about 
1.023 MHz. but the interleaving of CPU and display cycles means that the 
RAM is being accessed at a 2 MHz rate, or a cycle time of just under 
500 nanoseconds. Data for the CPU is strobed by the falling edge of 4>0, and 
display data is strobed by the falling edge of <£l, as shown in Figure 7-9. 
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Figure 7-9. RAM Timing Signals 
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The RAM timing looks complicated because the RAM address is 
multiplexed, as described in the previous section. The MMU takes care of 
multiplexing the address for the CPU cycle, and the IOU performs the same 
function for the display cycle. The multiplexed address is sent to the RAM 
ICs over the lines labelled RA0-RA7. Along with the other timing signals, the 
PAL device generates two signals that control the RAM addressing: 
row-address strobe (RAS) and column-address strobe (CAS). 

Table 7-10. RAM Timing Signal Descriptions 

Signal Name Description 

00 Clock phase (CPU phase) 

01 Clock phase 1 (display phase) 
RAS Row-address strobe 

CAS Column-address strobe 

Q3 Alternate RAM/column-address strobe 

RA0-RA7 Multiplexed address bus 

MD0-MD7 Internal data bus 



The Video Display 



The Apple He produces a video signal that creates a display on a standard 
video monitor or, if you add an RF modulator, on a black-and-white or color 
television set. The video signal is a composite made up of the data that is 
being displayed plus the horizontal and vertical synchronization signals that 
the video monitor uses to arrange the lines of display data on the screen. 

Video Standards: Apple He's manufactured for sale in the U.S. 
generate a video signal that is compatible with the standards set by the 
NTSC (National Television Standards Committee). Apple He's 
manufactured for sale in European countries generate video that is 
compatible with the standard used there, which is called P.A.L. (for 
phase alternating lines). This manual describes only the NTSC version of 
the video circuits. 



The Video Display 
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The display portion of the video signal is a time-varying voltage generated 
from a stream of data bits, where a 1 corresponds to a voltage that generates 
a bright dot, and a to a dark dot. The display bit stream is generated in 
bursts that correspond to the horizontal lines of dots on the video screen. 
The signal named WNDW is low during these bursts. 

During the time intervals between bursts of data, nothing is displayed on 
the screen. During these intervals, called the blanking intervals, the display 
is blank and the WNDW signal is high. The synchronization signals, called 
sync for short, are produced by making the signal named SYNC low during 
portions of the blanking intervals. The sync pulses are at a voltage 
equivalent to blacker-than-black video and don't show on the screen. 



The Video Counters 

The address and timing signals that control the generation of the video 
display are all derived from a chain of counters inside the IOU, Only a few 
of these counter signals are accessible from outside the IOU, but they are all 
important in understanding the operation of the display generation process, 
particularly the display memory addressing described in the next section. 

The horizontal counter is made up of seven stages: HO, HI, H2, H3, H4, H5, 
and HPE'. The input to the horizontal counter is the 1 MHz signal that 
controls the reading of data being displayed. The complete cycle of the 
horizontal counter consists of 65 states. The six bits HO through H5 count 
normally from to 63, then start over at 0. Whenever this happens, HPE' 
forces another count with HO through H5 held at zero, thus extending the 
total count to 65. 

The IOU uses the forty horizontal count values from 25 through 64 in 
generating the low-order part of the display data address, as described later 
in this chapter in the section "Display Address Mapping." The IOU uses the 
count values from to 24 to generate the horizontal blanking, the horizontal 
sync pulse, and the color-burst gate. 
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When the horizontal count gets to 65, it signals the end of a line by 
triggering the vertical counter. The vertical counter has nine stages; VA, 
VB, VC, VO, VI, V2, V3, V4, and V5. When the vertical count reaches 262, 
the IOU resets it and starts counting again from zero. Only the first 192 
scanning lines are actually displayed; the IOU uses the vertical counts from 
192 to 261 to generate the vertical blanking and sync pulse. Nothing is 
displayed during the vertical blanking interval. (The vertical line count is 
262 rather than the standard 262.5 because, unlike normal television, the 
Apple lie's video display is not interlaced.) 

Smooth Animation: Animation displays sometimes have an erratic 
flicker caused by changing the display data at the same time it is being 
displayed. You can avoid this on the Apple lie by reading the 
vertical-blanking signal (VBL) at location SCO 19 and changing display 
data while VBL Is low only (data value less than 128). 



Display Memory Addressing 

As described in Chapter 2 in the section "Addressing Display Pages 
Directly," data bytes are not stored in memory in the same sequence in 
which they appear on the display. You can get an idea of the way the 
display data is stored by using the Monitor to set the display to graphics 
mode, then storing data starting at the beginning of the display page at 
hexadecimal $400 and watching the effect on the display. If you do this, you 
should use the graphics display instead of text to avoid confusion: the text 
display is also used for Monitor input and output. 

If you want your program to display data by storing it directly into the 
display memory, you must first transform the display coordinates into the 
appropriate memory addresses, as shown in the section "Video Display 
Pages" in Chapter 2. The descriptions that follow will help you understand 
how this address transformation is done and why it is necessary. They will 
not (alas!) eliminate that necessity. 

The address transformation that folds three rows of forty display bytes into 
128 contiguous memory 7 locations is the same for all display modes, so it is 
described first. The differences among the different display modes are then 
described in the section "Video Display Modes." 
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The requirements of the RAM refreshing 
are discussed earlier in this chapter in the 
section "Dvnamic-RAM Refreshment." 



Display Address Mapping 

Consider the simplest display on the Apple He, the 40-column text mode. To 
address forty columns requires six bits, and to address twenty-four rows 
requires another five bits, for a total of eleven address bits. Addressing the 
display this way would involve 2048 (2 to the eleventh power) bytes of 
memory to display a mere 960 characters. The 80-column text mode would 
require 4096 bytes to display 1920 characters. The leftover chunks of 
memory that were not displayed could be used for storing other data, but 
not easily, because they would not be contiguous. 

Instead of using the horizontal and vertical counts to address memory 
directly, the circuitry inside the IOU transforms them into the new address 
signals described below. The transformed display address must meet the 
following criteria: 

a Map the 960 bytes of 40-column text into only 1024 bytes, 
a Scan the low-order address to refresh the dynamic RAMs. 
d Continue to refresh the RAMs during video blanking. 

The transformation involves only horizontal counts H3. H4, and H5, and 
vertical counts V3 and V4. Vertical count bits VA, VB. and VC address the 
lines making up the characters, and are not involved in the address 
transformation. The remaining low-order count bits, HO. HI, H2, V0, VI, and 
V2 are used directly, and are not involved in the transformation. 

The IOU performs an addition that reduces the five significant count bits to 
four new signals called SO, SI, S2, and S3, where S stands for sum. 
Figure 7-10 is a diagram showing the addition in binary form, with V3 
appearing as the carry in and H5 appearing as its complement H5'. 
A constant value of 1 appears as the low-order bit of the addend. The carry 
bit generated with the sum is not used. 



Table 7-11. Display Address Transformation 
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If this transformation seems terribly obscure, try it with actual values. For 
example, for the upper-left corner of the display, the vertical count is and 
the horizontal count is 24; HO, HI, H2, and H5 are O's and H3, and H4 are l's. 
The value of the sum is 0, so the memory location for the first character on 
the display is the first location in the display page, as you might expect. 

Horizontal bits HO, HI, and H2 and sum bits SO, SI, and S2 make up the 
transformed horizontal address (A0 through A6 in Table 7-12), As the 
horizontal count increases from 24 to 63, the value of the sum 
(S3 S2 SI SO) increases from to 4 and the transformed address goes from 
to 39, relative to the beginning of the display page. 

The low-order three bits of the vertical row counter are VO, VI, and V2. 
These bits control address bits A7, A8, and A9, as shown in Table 7-12, so 
that rows through 7 start on 127-byte boundaries. When the vertical row 
counter reaches 8, then VO, VI, and V2 are again, and V3 changes to 1. If 
you do the addition in Table 7-1 1 with H equal to 24 (the horizontal count 
for the first column displayed) and V equal to 8, the sum is 5 and the 
horizontal address is 40: the first character in row 8 is stored in the memory 
location 40 bytes from the beginning of the display page. 

Figure 7-10. 40-Column Text Display Memory 

Memory locations marked with an asterisk (*) are reserved for use by peripheral 
I/O firmware: refer to the section 'Peripheral-Card RAM Space" in Chapter 6. 
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Figure 7-10 shows how groups of three forty-character rows are stored in 
blocks of 120 contiguous bytes starting on 127-byte address boundaries. 
This diagram is another way of describing the display mapping shown in 
Figure 2-5. Notice that the three rows in each block of 120 bytes are not 
adjacent, on the display. 

Table 7-12 shows how the signals from the video counters are assigned to 
the address lines. HO, HI, and H2 are horizontal-count bits, and V0, VI, and 
V2 are vertical-count bits. SO, SI, S2 and S3 are the folded address bits 
described above. Address bits marked with asterisks (*) are different for 
different modes: see Table 7-13 and the four subsections under the section 
"Video Display Modes." 

Table 7-12. Display Memory Addressing 



Memory 


Display 


Memory 


Display 


Address Bit 


Address Bit 


Address Bit 


Address Bit 


A!' 


HO 


A8 


VI 


Al 


HI 


A9 


V2 


A2 


H2 


A10 


** 


A: 


SO 


All 


*# 


A4 


SI 


A12 


** 


AS 


s. 


A13 


** 


A6 


S3 


A14 


+* 


A7 


vo 


A15 


GND 



** For these address bits, see text and Table 7-13. 



Table 7-13. Memory Address Bits for Display Modes 



. means 


logical AND; ' "means logical NOT. 




Display 


Modes 


Address 


Text and 


High-Resolution and 


Bit 


Low-Resolution 


Double-High-Resolution 


A 10 


80STOBE+PAGE2' 


VA 


All 


80STORE'.PAGE2 


VB 


A 12 





vc 


AI3 





80STORE+PAGE2' 


A14 


!') 


80STORE'.PAGE2 
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Video Display Modes 

The different, display modes all use the address-mapping scheme described 
in the previous section, but they use different-sized memory areas in 
different locations. The next four sections describe the addressing schemes 
and the methods of generating the actual video signals for the different 
display modes. 

Text Displays 

The text and low-resolution graphics pages begin at memory locations 
S0400 and $0800. Table 7-13 shows how the display-mode signals control 
the address bits to produce these addresses. Address bits A10 and All are 
controlled by the settings of PG2 and 80STORE, which are set by the 
display-page and 80-column- video soft switches. Address bits A12, A 13, and 
A14 are set to 0. Notice that 80STORE active inhibits PG2: there is only one 
display page in 80-column mode. 

The bit patterns used for generating the different characters are stored in a 
32K ROM. The tow-order six bits of each data byte reach the character 
generator ROM directly, via the video data bus VID0-VID5. The two 
high-order bits are modified by the IOU to select between the primary and 
alternate character sets and are sent to the character generator ROM on 
lines RA9 and RA10. 

The data for each row of characters are read eight times, once for each of 
the eight lines of dots making up the row of characters. The data bits are 
sent to the character generator ROM along with VA, VB, and VC, the 
low-order bits from the vertical counter. For each character being displayed, 
the character generator ROM puts out one of eight stored bit patterns 
selected by the three-bit number made up of VA, VB, and VC. 

The bit patterns from the character generator ROM are loaded into the 
74166 parallel-to-serial shift register and output as a serial bit stream that 
goes to the video output circuit. The shift register is controlled by signals 
named LDPS' (for load parallel-to-serial shifter) and VID7M (for video 
7 MHz). In 40-column mode, LDPS' strobes the output of the character 
generator ROM into the shift register once each microsecond, and bits are 
sent to the screen at a 7 MHz rate. 
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The addressing for the 80-column display is exactly the same as for the 
40-column display; the 40 columns of display memory on the 80-column 
card are addressed in parallel with the 40 columns in main memory. The 
data from these two memories reach the video data bus (lines V1D0-VID7) 
via separate 74LS374 three-state buffers. These buffers are loaded 
simultaneously, but their outputs are sent to the character generator ROM 
alternately by 00 and 01. In 80-column mode, LDPS' loads data from the 
character generator ROM into the shift register twice during each 
microsecond, once during 00 and once during ^1, and bits are sent to the 
screen at a 14 MHz rate. Figures 7-1 la and 7-1 lb show the video timing 
signals. 



Figure 7-1 la. 7 MHz Video Timing Signals 
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Figure 7-1 lb. 14 MHz Video Timing Signals 
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Low-Resolution Display 

In the graphics modes, VA and VB are not used by the character generator, 
so the IOU uses lines SEGA and SEGB to transmit HO and HIRES', as shown 
in Table 7-14. 



Table 7-H. Character-Generator Control Signals 



Display 
Mode 


SEGA 


SEGB 


SEGC 


Text 


VA 


VB 


vc 


Graphics 


BO 


HIRES' 


vc 



The low-resolution graphics display uses VC to divide the eight display lines 
corresponding to a row of characters into two groups of four lines each. 
Each row of data bytes is addressed eight times, the same as in text mode, 
but each byte is interpreted as two nibbles. Each nibble selects one of 16 
colors. During the upper four of the eight display lines, VC is low and the 
low-order nibble determines the color. During the lower four display lines, 
VC is high and the high-order nibble determines the color. 

The bit patterns that produce the low-resolution colors are read from the 
character-generator ROM in the same way the bit patterns for characters 
are produced in text mode. The 74166 parallel-to-serial shift register 
converts the bit patterns to a serial bit stream for the video circuits. 

The video signal generated by the Apple He includes a short, burst of 
3.58 MHz signal that is used by an NTSC color monitor or color TV set to 
generate a reference 3.58 MHz color signal. The Apple lie's video signal 
produces color by interacting with this 3.58 MHz signal inside the monitor or 
TV set. Different bit patterns produce different colors by changing the duty 
cycles and delays of the bit stream relative to the 3.58 MHz color signal. To 
produce the small delays required for so many different colors, the shift 
register runs at 14 MHz and shifts out 14 bits during each cycle of the 1-MHz 
data clock. To generate a stream of fourteen bits from each eight-bit pattern 
read from the ROM, the output of the shift register is connected back to the 
register's serial input to repeat the same eight bits; the last two bits are 
ignored the second time around. 
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Each bit pattern is output for the same amount of time as a character: .98 
microseconds. Because that is exactly enough time for three and a half 
cycles of the 3.58 MHz color signal, the phase relationship between the bit 
patterns and the signal changes by a half cycle for each successive pattern. 
To compensate for this, the character generator ROM puts out, one of two 
different bit patterns for each nibble, depending on the state of HO, the 
low-order bit of the horizontal counter. 



High-Resolution Display 

The high-resolution graphics pages begin at memory locations $2000 and 
$4000 (decimal 8192 and 16384). These page addresses are selected by 
address bits A13 and A14. In high-resolution mode, these address bits are 
controlled by PG2 and 80STORE, the signals controlled by the display-page 
(PAGE2) and 80-column-video (80COL) soft switches. As in text mode, 
80STORE inhibits addressing of the second page because there is only one 
page of 80-column text available for mixed mode. 

In high-resolution graphics mode, the display data are still stored in blocks 
like the one shown in Figure 7-10, but. there are eight of these blocks. As 
Table 7-12 and Table 7-13 show, vertical counts VA, VB, and VC are used 
for address bits A10, All, and A12, which address eight blocks of 1024 bytes 
each. Remember that in the display, VA, VB, and VC count adjacent 
horizontal lines in groups of eight. This addressing scheme maps each of 
those lines into a different 1024-byte block. It might help to think of it as a 
kind of eight- way multiplexer: it's as if eight text displays were combined to 
produce a single high-resolution display, with each text display providing 
one line of dots in turn, instead of a row of characters. 

The high-resolution bit patterns are produced by the character-generator 
ROM. In this mode, the bit patterns simply reproduce the eight bits of 
display data. The low-order six bits of data reach the ROM via the video 
data bus VID0-VID5. The IOU sends the other two data bits to the ROM via 
RA9 and RA10. 

The high-resolution colors described in Chapter 2 are produced by the 
interaction between the video signal the bit patterns generate and the 
3.58 MHz color signal generated inside the monitor or TV set. The 
high-resolution bit patterns are always shifted out at 7 MHz, so each dot 
corresponds to a half-cycle of the 3.58 MHz color signal. Any part of the 
video signal that produces a single white dot between two black dots, or 
vice versa, is effectively a short burst of 3.58 MHz and is therefore displayed 
as color. In other words, a bit pattern consisting of alternating Ts and 0's 
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gets displayed as a line of color. The high-resolution graphics subroutines 
produce the appropriate bit patterns by masking the data bits with 
alternating l's and O's. 

To produce different colors, the bit patterns must have different phase 
relationships to the 3.58 MHz color signal. If alternating l's and O's produce 
a certain color, say green, then reversing the pattern to O's and l's will 
produce the complementary color, purple. As in the low-resolution mode, 
each bit pattern corresponds to three and a half cycles of the color signal, so 
the phase relationship between the data bits and the color signal changes by 
a half cycle for each successive byte of data. Here, however, the bit patterns 
produced by the hardware are the same for adjacent bytes; the color 
compensation is performed by the high-resolution software, which uses 
different color masks for data being displayed in even and odd columns. 

To produce other colors, bit patterns must have other timing relationships 
to the 3.58 MHz color signal. In high-resolution mode, the Apple He produces 
two more colors by delaying the output of the shift register by half a dot 
(70 ns), depending on the high-order bit of the data byte being displayed. 
(The high-order bit doesn't actually get displayed as a dot, because at 7 MHz 
there is only time to shift out seven of the eight bits.) 

As each byte of data is sent from the character generator to the shift 
register, high-order data bit D7 is also sent to the PAL device. If D7 is off, the 
PAL device transmits shift-register timing signals LDPS' and VID7M 
normally. If D7 is on, the PAL device delays LDPS' and V1D7M by 70 
nanoseconds, the time corresponding to half a dot. The bit pattern that 
formerly produced green now produces orange; the pattern for purple now 
produces blue. 

A Note About Timing: For 80-column text, the shift register is clocked 
at twice normal speed. When 80-column text is used with graphics in 
mixed mode, the PAL device controls shift-register timing signals LDPS' 
and VID7M so that the graphics portion of the display works correctly 
even when the text window is in 80-column mode. 
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Double-High-Res olution Display 

Double-high-resolution graphics mode displays two bytes in the time 
normally required for one, but uses high-resolution graphics Page 1 in both 
main and auxiliary memory instead of text or low-resolution Page 1. 

Note: There is a second pair of pages, high-resolution Page 2, which can 
be used to display a second double-high-resolution page. 

Double-high-resolution graphics mode displays each pair of data bytes as 14 
adjacent dots, seven from each byte. The high-order bit (color-select bit) of 
each byte is ignored. The auxiliary-memory byte is displayed first, so data 
from auxiliary memory appears in columns 0-6, 14-20, and so on, up to 
columns 547-552. Data from main memory appears in columns 7-13, 21-27, 
and so on, up to 553-559. 

As in 80-column text, there are twice as many dots across the display 
screen, so the dots are only half as wide. On a TV set or low-bandwidth 
monitor (less than 14 MHz), single dots will be dimmer than normal. 

Note: Except for some expensive RGB-type monitors, any video monitor 
with a bandwidth as high as 14 MHz will be a monochrome monitor. 
Monochrome means one color; a monochrome video monitor can have a 
screen color of white, green, orange, or any other single color. 

The main memory and auxiliary memory are connected to the address bus 
in parallel, so both are activated during the display cycle. The rising edge of 
#0 clocks a byte of main memory data into the video latch, and a byte of 
auxiliary memory data into the 80 latch. 

Phi 1 01) enables output from the (auxiliary) 80 latch, and <t>0 enables 
output from the (main) video latch, Output from both latches goes to 
CHARGEN, where GR and SEGB' select high-resolution graphics. LDPS 
operates at 2 MHz in this mode, alternately gating the auxiliary byte and 
main byte into the parallel-to-serial shift register. VID7M is active (kept 
true) for double-high-resolution display mode, so when it is ANDed with 
14M, the result is still 14M. The 14M serial clock signal gate shift register 
then outputs to VID, the video display hybrid circuit, for output to the 
display device. 
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Video Output Signals 



The stream of video data generated by the display circuits described above 
goes to a linear summing circuit built around transistor Ql where it is mixed 
with the sync signals and the color burst. Resistors R3, R5, R7, RIO, R13, 
and R15 adjust the signals to the proper amplitudes, and a tank circuit (L3 
and C32) resonant at 3.58 MHz conditions the color burst. 

The resulting video signal is an NTSC-compatible composite- video signal 
that can be displayed on a standard video monitor. The signal is similar to 
the E1A (Electronic Industries Association) standard positive composite 
video (see Table 7-15). This signal is available in two places in the Apple He: 

□ At the phono jack on the back of the Apple lie. The sleeve of this jack is 
connected to ground and the tip is connected to the video output through 
a resistor network that attenuates it to about 1 volt and matches its 
impedance to 75 ohms. 

□ At the internal video connector on the Apple He circuit board near the 
RCA jack, J13 in Figure 7-13c. It is made up of four Molex-type pins, 
0.25 inches tall, on 0.10 inch centers. This connector carries the video 
signal, ground, and two power supplies, as shown in Table 7-15. 



Table 7-15. Internal Video Connector Signals 

Note: Pin 1 is the pin closest to the keyboard; pin 4 is at the back. 



Pin 

I 



Name Description 

GROUND System common ground 

VIDEO NTSC-compatible positive composite video. White 

level is about 2.0 volts, black level is about 0.75 
volts, and sync level is 0.0 volts. This output is not 
protected against short-circuits. 

-5V -5 volt power supply 

+ 12 V +12 volt power supply 
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Built-in I/O Circuits 



The use of the Apple He's built-in I/O features is described in Chapter 2. 
This section describes the hardware implementation of all of those features 
except the video display described in the previous sections. 

The IOU (Input/Output Unit) directly generates the output signals for the 
speaker, the cassette interface, and the annunciators. The other I/O 
features are handled by smaller ICs, as described later in this section. 

The addresses of the built-in I/O features are described in Chapter 2 and 
listed in Table 2-2, Table 2-11, and Table 2-12. All of the built-in I/O 
features except the displays use memory locations between SC00O and 
$C070 (decimal 49152 and 49264). The I/O address decoding is performed 
by three ICs: a 74LS138, a 74LS154, and a 74LS251. 

The 74LS138 decodes address lines A8, A9, A 10, and All to select address 
pages on 256-byte boundaries starting at $C000 (decimal 49152). When it 
detects addresses between SCG00 and SCOFF, it enables the IOU and the 
74LS154. The 74LS154 in turn decodes address lines A4, A5, A6, and A7 to 
select 16-byte address areas between $C000 and SCOFF. Addresses between 
SC060 and v $C06F enable the 74LS251 that multiplexes the hand control 
switches and paddles; addresses between $C070 and $C07F reset the NE558 
quadruple timer that interfaces to the hand controls, as described later in 
the section "Game I/O Signals." 



The Keyboard 

The Apple He's keyboard is a matrix of keyswitches connected to an 
AY-3600-type keyboard decoder via a ribbon cable and a 26-pin connector. 
The AY-3600 scans the array of keys over and over to detect any keys 
pressed. The scanning rate is set by the external resistor-capacitor network 
made up of C70 and R32. The debounce time is also set externally, by C71. 

The AY-3600's outputs include five bits of key code plus separate lines for 
I control | , 1 shift [ . any-key-down, and keyboard strobe. The 
any-key-down and keyboard-strobe lines are connected to the IOU, which 
addresses them as soft switches. The key-code lines, along with | control | 
and | shift 1 , are inputs to a separate 2316 ROM. The ROM translates them 
to the character codes that are enabled onto the data bus by signals named 
KBD' and ENKBD'. The KBD' signal is enabled by the MMU whenever a 
program reads location SCOOG, as described in the section "Reading the 
Keyboard" in Chapter 2. 
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Table 7-16. Keyboard Connector Signals 



Pin Number 


Name 


Description 


1,2,4,6,8,10, 
23,25,12,22 


Y0-Y9 


Y- direction key-matrix connections 


3 


+5 


+5 volt supply 


5,7,9,15 


n.c. 




i 


LCNTL' 


Line from | control | key 


13 


GND 


System common ground 


14,16,20,21, 
19,26,17 


X0-X7 


X-direction key-matrix connections 



24 



LSHFT' Line from [smrf] key 



Connecting a Keypad 

There is a smaller connector wired in parallel with the keyboard connector. 
You can connect a ten-key numeric pad to the Apple He via this connector. 



Table 7-17. Keypad Connector Signals 



Pin Number Name 

1,2,5,3.4,6 Y0-Y5 

7 n.c. 

9,11,10,8 X4-X7 



Description 

Y-direction key-matrix connections 

X-direction key-matrix connections 
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Cassette I/O 

The two miniature phone jacks on the back of the Apple He are used to 
connect an audio cassette recorder for saving programs. The output signal 
to the cassette recorder comes from a pin on the IOU via resistor network R6 
and R9, which attenuates the signal to a level appropriate for the recorder's 
microphone input. Input from the recorder is amplified and conditioned by a 
type 741 operational amplifier and sent to one of the inputs of the 74LS251 
input multiplexer, 

The signal specifications for cassette I/O are 

□ Input: 1 volt (nominal) from recorder earphone or monitor output. Input 

impedance is 12K ohms. 
d Output: 25 millivolts to recorder microphone input. Output impedance is 

100 ohms. 



The Speaker 

The Apple He's built-in loudspeaker is controlled by a single bit of output 
from the IOU (Input Output Unit). The signal from the IOU is AC coupled to 
Q5. an MPSA13 Darlington transistor amplifier. The speaker connector is a 
Molex KK100 connector, J18 in Figure 7-13b, with two square pins 0.25 
inches tall and on 0.10-inch centers. 

A light-emitting diode is connected in parallel across the speaker pins such 
that, when the speaker is not connected, the diode glows whenever the 
speaker signal is on. This diode is used as a diagnostic indicator during 
assembly and testing of the Apple lie. 

Table 7-18. Speaker Connector Signals 



Pin 
Number 

i 



Name 

SPKR 

+6 



Description 

Speaker signal. This line will deliver about 
0.5 watts into an 8-ohm speaker. 

+5V power supply. Note that the speaker is not 
connected to system ground. 
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Game I/O Signals 

Several I/O signals that are individually controlled via soft switches are 
collectively referred to as the game signals. Even though they are normally 
used for hand controls, these signals can be used for other simple I/O 
applications, There are five output, signals; the four annunciators, 
numbered AO through A3, and one strobe output. There are three one-bit 
inputs, called switches and numbered S WO through SW2, and four analog 
inputs, called paddles and numbered PDLO through PDL3. 

The annunciator outputs are driven directly by the IOU (Input Output Unit). 
These outputs can drive one TTL (transitor-transitor logic) load each; for 
heavier loads, you must use a transistor or a TTL buffer on these outputs. 
These signals are only available on the 16-pin infernal connector. (See 
Table 7-19.) 

The strobe output is a pulse transmitted any time a program reads or writes 
to location $C040. The strobe pin is connected to one output of the 74LS154 
address decoder. This TTL signal is normally high: it goes low during 00 of 
the instruction cycle that addresses location SG040. This signal is only 
available on the 16-pin internal connector. (See Table 7-19.) 

The game inputs are multiplexed along with the cassette input signal by a 
74LS251 eight-input multiplexer enabled by the C06X' signal from the 
74LS154 I/O address decoder. Depending on the low-order address, the 
appropriate game input is connected to bit 7 of the data bus, 

The switch inputs are standard low-power Schottky TTL inputs. To use 
them, connect each one to 560-ohm pull-down resistors connected to the 
ground and through single-pole, momentary-contact pushbutton switches to 
the +5 volt supply. 

The hand-control inputs are connected to the timing inputs of an NE558 
quadruple 555-type analog tuner. Addressing $C07X sends a signal from the 
74LS154 that resets all four timers and causes their outputs to go to 
1 (high). A variable resistance of up to 150K ohms connected between one 
of these inputs and the +5V supply controls the charging time of one of four 
0,022-microfarad capacitors. When the voltage on the capacitor passes a 
certain threshold, the output of the NE558 changes back to (low). 
Programs can determine the setting of a variable resistor by resetting the 
timers and then counting time until the selected timer input changes from 
high to low. The resulting count is proportional to the resistance. 
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The game I/O signals are all available on a 16-pin DIP socket labelled 
GAME I/O on the main circuit board inside the case. The switches and the 
paddles are also available on a D-type miniature connector on the back of 
the Apple He; see J8 and J15 in Figure 7-13d. 



Table 7-19. Game I/O Connector Signals 



Internal- 


Back- Panel- 






Connector 


Connector 






Pin Number 


Pin Number 


Signal Name 


Description 


1 


2 


+5V 


+5V power 



drain from this pin must, not 
exceed 100mA. 

2,3,4 7,1,6 PB0-PB2 Switch inputs. These are 

standard 74LS inputs. 

5 STROBE' Strobe output. This line goes low 

during 0o of a read or write 
instruction to location $0040. 

6,10,7,11 5,8.4,9 PDL0-PDL3 Hand control inputs. Each of 

these should be connected to a 
150K-ohm variable resistor 
connected to +5V. 

8 3 GND System ground. 

15,14,13,12 AX0-AN3 Annunciators. These are 

standard 74LS TTL outputs and 
must be buffered to drive other 
than TTL inputs, 

9,16 - n.c. Nothing is connected to these 

pins. 
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programming peripheral cards for the 
Apple He. 
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The main circuit board of the Apple lie has eight empty card connectors or 
slots on it These slots make it possible to add features to the Apple He by 
plugging in peripheral cards with additional hardware. This section 
describes the hardware that supports them, including all of the signals 
available on the expansion slots. 



The Expansion Slots 

The seven connectors lined up across the back part of the Apple He's main 
circuit card are the expansion slots, also called peripheral slots or simply 
slots, numbered from 1 to 7. They are 50-pin PC-card edge connectors with 
pins on 0.10-inch centers. A PC card plugged into one of these connectors 
has access to all of the signals necessary to perform input and output and to 
execute programs in RAM or ROM on the card. These signals are described 
briefly in Table 7-20, The following paragraphs describe the signals in 
general and mention a few points that are often overlooked. For further 
details, refer to the schematic diagram in Figures 7- 13a, 7-13b, 7-13c, and 
743d. 



The Peripheral Address Bus 

The microprocessor's address bus is buffered by two 74LS244 octal 
three-state buffers. These buffers, along with a buffer in the 
microprocessor's R/W line, are enabled by a signal derived from the DMA' 
daisy-chain on the expansion slots. Pulling the peripheral line DMA' low 
disables the address and R/W buffers so that peripheral DMA circuitry can 
control the address bus. The DMA address and R/W signals supplied by a 
peripheral card must be stable all during <t>Q of the instruction cycle, as 
shown in Figure 7-12. 

Another signal that can be used to disable normal operation of the Apple He 
is INH'. Pulling INH' low disables all of the memory in the Apple He except 
the part in the I/O space from SC000 to SCFFF. A peripheral card that uses 
either INH' or DMA' must observe proper timing; in order to disable RAM 
and ROM cleanly, the disabling signal must be stable all during ^0 of the 
instruction cycle (refer to the timing diagram in Figure 7-12). 
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The peripheral devices should use I/O SELECT' and DEVICE SELECT' as 
enables. Most peripheral ICs require their enable signals to be present for a 
certain length of time before data is strobed into or out of the device. 
Remember that I/O SELECT' and DEVICE SELECT' are only asserted 
during 4>d high. 



The Peripheral Data Bus 

The Apple He has two versions of the microprocessor data bus: an internal 
bus, MD0-MD7, connected directly to the microprocessor; and an external 
bus, D0-D7, driven by a 74LS245 octal bidirectional bus buffer. The 65C02 is 
fabricated with MOS circuitry, so it can drive capacitive loads of up to about 
130 pF. If peripheral cards are installed in all seven slots, the loading on the 
data bus can be as high as 500 pF, so the 74LS245 drives the data bus for the 
peripheral cards. The same argument applies if you use MOS devices on 
peripheral cards; they don't have enough drive for the fully-loaded bus, so 
you should add buffers. 

Loading and Driving Rules 

Table 7-20 shows the drive requirements and loading limits for each pin on 
the expansion slots. The address bus, the data bus, and the R/W line 
should be driven by three-state buffers. Remember that there is 
considerable distributed capacitance on these busses and that you should 
plan on tolerating the added load of up to six additional peripheral cards. 
MOS devices such as PIAs and ACIAs cannot switch such heavy capacitive 
loads. Connecting such devices directly to the bus will lead to possible 
timing and level errors. 

Interrupt and DMA Daisy Chains 

The interrupt requests (IRQ' and NMF) and the direct-memory access 
(DMA') signal are available at all seven expansion slots. A peripheral card 
requests an interrupt or a DMA transfer by pulling the appropriate output 
line low (active). If two peripheral cards request an interrupt or a DMA 
transfer at the same time, they will contend for the data and address 
busses. To prevent this, two pairs of pins on each connector are wired as a 
priority daisy chain. The daisy-chain pins for interrupts are INT IN and INT 
OUT, and the pins for DMA are DMA IN and DMA OUT, as shown for J1-J7 
in Figure 7-13d. 
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Each daisy chain works like this; the output from each connector goes to 
the input of the next higher numbered one. For these signals to be useful for 
cards in lower numbered connectors, all of the higher numbered connectors 
must have cards in them, and all of those cards must connect DMA IN to 
DMA OUT and INT IN to INT OUT. Whenever a peripheral card uses pin 
DMA', it must do so only if its DMA IN line is active, and it must disable its 
DMA OUT line while it is using DMA'. The INT IN and INT OUT lines must 
be used the same way: enable the card's interrupt circuits with INT IN, and 
disable INT OUT whenever IRQ' or NMI' is being used. 

Figure 742. Peripheral- Signal Timing 

HM rixuiruuiJijm^ 
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CPU Phase 
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Table 7-20. Expansion Slot Signals 



Pin 

1 

2-17 

18 
19 

20 
21 

22 



Name 

I/O SELECT 

A0-A15 

R/W 

SYNC 

I/O STROBE' 

RDY 

DMA' 



2: ; 


INT OUT 


U 


DMA OUT 


25 


+5V 


26 


GND 


27 


DMA IN 


28 


INT IN 


2y 


NOT 



Description 

Normally high; goes low during $0 when the 65C02 

addresses location $CnXX, where n is the connector 

number. This line can drive 10 LS TTL loads.* 

Three- state address bus. The address becomes 

valid during 01 and remains valid during 00. Each 

address line can drive 5 LS TTL loads.* 

Three-state read/write line. Valid at the same time 

as the address bus; high during a read cycle, low 

during a write cycle. It can drive 2 LS TTL loads.* 

Composite horizontal and vertical sync, on 

expansion slot 7 only. This line can drive 2 LS TTL 

loads.* 

Normally high; goes low during 00 when the 65C02 

addresses a location between $C800 and $CFFF. 

This line can drive 4 LS TTL loads. 

Input to the 65C02. Pulling this line low during 01 

halts the 65C02 with the address bus holding the 

address of the location currently being fetched. 

This line has a 3300 ohm pullup resistor to +5V. 

Input to the address bus buffers. Pulling this line 

low during 01 disconnects the 65C02 from the 

address bus. This line has a 3300 ohm pullup 

resistor to +5V, 

Interrupt priority daisy-chain output. Usually 

connected to pin 28 (INT IN),t 

DMA priority daisy-chain output. Usually 

connected to pin 22 (DMA IN). 

+5-volt power supply. A total of 500mA is available 

for all peripheral cards. 

System common ground. 

DMA priority daisy-chain input. Usually connected 

to pin 24 (DMA OUT). 

Interrupt priority daisy-chain input. Usually 

connected to pin 23 (INT OUT). 

Non-maskable interrupt to 65C02. Pulling this line 

low starts an interrupt cycle with the 

interrupt-handling routine at location $03FB. This 

line has a 3300 ohm pullup resistor to +5V. 
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Table 7-20 — Continued. Expansion Slot Signals 



Pin 



4249 



m 



Name 

mcy 



31 


RES' 


32 


INH' 


33 


-12V 


34 


■6V 


35 


3.58M 


36 


7M 


3 7 


Q3 


38 


01 


39 


mPSYNC 


40 


00 


41 


DEVICE 
SELECT' 



D0-D7 



+ 12V 



Description 

Interrupt request to 65C02. Pulling this line low 

starts an interrupt cycle only if the 

interrupt-disable (I) flag in the 65C02 is not set. 

Uses the interrupt-handling routine at location 

S03FE. This line has a 3300 ohm pullup resistor to 

+5V. 

Pulling this line low initiates a reset routine, as 

described in Chapter 4, 

Pulling this line low during 01 inhibits (disables) 

the memory on the main circuit board. This line 

has a 3300 ohm pullup resistor to +5V. 

-12 volt power supply. A total of 200mA is available 

for all peripheral cards. 

-5 volt power supply. A total of 200mA is available 

for all peripheral cards. 

3.58 MHz color reference signal, on slot 7 only. This 

line can drive 2 LS TTL loads.* 

System 7 MHz clock. This line can drive 2 LS TTL 

loads.* 

System 2 MHz asymmetrical clock. This line can 

drive 2 LS TTL loads.* 

65C02 phase 1 clock. This line can drive 2 LS TTL 

loads.* 

The 65C02 signals an operand fetch by driving this 

line high during the first read cycle of each 

instruction. 

65C02 phase clock. This line can drive 2 LS TTL 

loads.* 

Normally high; goes low during 00 when the 65C02 

addresses location SCOnX, where n is the connector 

number plus 8. This line can drive 10 LS TTL 

loads.* 

Three-state buffered bi-directional data bus. Data 

becomes valid during 00 high and remains valid 

until 00 goes low. Each data line can drive one 

LS TTL load.* 

+ 12 volt power supply. A total of 250mA is 

available for all peripheral cards. 



* Loading limits are for each card. 

t On slot 7 only, this pin can be connected to the graphics-raode signal GR: see text for 
details. 
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Auxiliary Slot 

The large connector at the left side of the Apple lie's main circuit card is the 
auxiliary slot. It is a 60-pin PC-card edge connector with pins on 0.10-inch 
centers. A PC card plugged into this connector has access to all of the 
signals used in producing the video display. These signals are described 
briefly in Table 7-21, For further details, refer to the schematic diagram in 
Figures 7-13a, 7-13b, 7-13c, and 7-1 3d. 

Many of the internal signals that are not available on the expansion slots 
are on the auxiliary slot. By using both kinds of connectors, manufacturing 
and repair personnel can gain access to most of the signals needed for 
diagnosing problems in the Apple He. 

80-Column Display Signals 

The additional memory needed for producing an 80-column text display is 
on the 80-column text card, along with the buffers that transfer the data to 
the video data bus, as described earlier in this chapter in the section "Text 
Displays. 1 ' The signals that control the 80-column text data include the 
system clocks tf>0 and <f>l, the multiplexed RAM address RA0-RA7, the RAM 
address-strobe signals PRAS' and PCAS', and the auxiliary-RAM enable 
signals, EN80' and R/W80. The EN80' enable signal is controlled by the 
80STORE soft switch described in Chapter 4. Data is sent to the auxiliary 
memory via the internal data bus MD0-MD7; the data is transferred to the 
video generator via the video data bus VID0-VID7. 
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Table 7-21. Auxiliary Slot Signals 



Pin 

1 



Name 

3.58M 

VID7M 



3 


SYNC 


4 


PRAS' 


5 


vc 


6 


C07X' 


7 


WNDW 


8 


SEGA 


51,10,49,48, 


RA0-RA7 


13,14,46,9 




11,12 


R0MEN1, 




R0MEN2 


44,43,40,39, 


MD0-MD7 


21,20,17,16 




45,42,41,38, 


VID0-VID1 


22,19,18,15 




23 


<£0 


2-1 


CLRGAT' 


25 


80VID' 


2^ 


EN80' 


27 


ALTVID' 


28 


SEROUT' 


29 


ENVID' 



Description 

3.58 MHz video color reference signal. This line can 

drive two LS TTL loads. 

Clocks the video dots out of the 74166 

parallel-to-serial shift register. This line can drive two 

LS TTL loads. 

Video horizontal and vertical sync signal. This line 

can drive two LS TTL loads. 

Multiplexed RAM row-address strobe. This line can 

drive two LS TTL loads. 

Third low-order vertical-counter bit. This line can 

drive two LS TTL loads. 

Hand-control reset signal. This line can drive two LS 

TTL loads. 

Video non -blank window. This line can drive two LS 

TTL loads. 

First low-order vertical counter bit. This line can 

drive two LS TTL loads. 

Multiplexed RAM-address bus. This line can drive 

two LS TTL loads. 

Enable signals for the ROMs on main circuit board. 



Internal (unbuffered) data bus. This line can drive 
two LS TTL loads. 
VID0-VID7 Video data bus. This three-state bus carries video 
data to the character generator. 
65C02 clock phase 0. This line can drive two LS TTL 
loads. 

Color-burst gating signal. This line can drive two LS 
TTL loads. 

Enables 80-column display timing. This line can drive 
two LS TTL loads. 

Enable for auxiliary RAM. This line can drive two LS 
TTL loads. 

Alternative video output to the video summing 
amplifier. 

Video serial output from 74166 parallel-to-serial shift 
register. 

Normally low; driving this line high disables the 
character generator such that the video dots from the 
shift register are all high (white), and alternative 
video can be sent out via ALTVID'. This line has a 
1000 ohm pulldown resistor to ground. 
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Table 7-21— Continued. Auxiliary Slot Signals 



Pin 

m 

31 

82 



34 



36 

87 

47 
50 

52 
53 
54 
55 
56,57 



Name Description 

+5 +5 volt power supply. 

GND System common ground. 

14M 14.3 MHz master clock signal This line can drive two 

LSTTL loads. 
PCAS' Multiplexed column-address strobe. This line can 

drive two LS TTL loads. 
LDPS' Strobe to video parallel-to-serial shift register. This 

signal goes low to load the contents of the video data 

bus into the shift register. This line can drive two LS 

TTL loads. 
R/W80 Read/write signal for RAM on the card in this slot. 

This line can drive two LS TTL loads. 
01 65C02 clock phase 1. This line can drive two LS TTL 

loads. 
CASEN' Column-address enable. This signal is disabled (held 

high) during accesses to memory on the card in this 

slot. This line can drive two LS TTL loads. 
HO Low-order horizontal byte counter. This line can drive 

two LS TTL loads. 
AN3 Output of annunciator number 3. This line can drive 

two LS TTL loads. 
R/W' 65C02 read/write signal. This line can drive two LS 

TTL loads. 
Q3 2 MHz asymmetrical clock. This line can drive two LS 

TTL loads. 
SEGB Second low-order vertical-counter bit. This line can 

drive two LSTTL loads. 
FRCTXT' Normally high; pulling this line low enables 14MHz 

video output even when GR is active. 
RA9',RA10' Character-generator control signals from the 10U. 

This line can drive two LS TTL loads. 
GR Graphics-mode enable signal. This line can drive two 

LS TTL loads. 
7M 7 MHz timing signal. This line can drive two LS TTL 

loads. 
ENTMG' Normally low; pulling this line high disables the 

master timing from the PAL device, This line has a 

1000 ohm pulldown resistor to ground. 
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This appendix contains a description of the differences between the 6502 
and the 65C02 microprocessors. It also contains the data sheet for the 65C02 
microprocessor. 

The 6502 microprocessor was used in the original Apple He, Apple II Plus, 
and Apple II. The 65C02 is a 6502 that uses less power and has ten new 
instructions and two new addressing modes, The 65C02 is used in both the 
enhanced Apple lie and the Apple He. 

In the data sheet tables, execution times are specified in number of cycles. 
One cycle time for the Apple He equals 0.978 microseconds, giving a system 
clock rate of about 1.02 MHz. 

Note: If you want to write programs that execute on all computers in the 
Apple II series, use only those 65C02 instructions that are also present on 
the 6502. 



Differences Between 6502 and 65C02 

The data sheet lists the instructions and addressing modes of the 65C02. 
This section supplements that information by listing those instructions 
whose execution times or results differ in the 6502 and the 65C02. 



Different Cycle Times 

A few instructions on the 65C02 operate in different numbers of cycles than 
their 65C02 equivalents. These instructions are listed in Table A-l. 



Table A-l. Cycle Time Differences 







6502 


65C02 


Instruction/Mode 


Opcode 


Cycles 


Cycles 


ASL Absolute. X 


IE 


7 


6 


DEC Absolute, X 


DE 


7 


6 


INC Absolute, X 


FE 


7 


f) 


JMP (Absolute) 


6C 


5 


6 


LSR Absolute, X 


5E 


7 


6 


ROL Absolute, X 


3E 


7 


6 


ROR Absolute, X 


7E 


7 


6 
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Different Instruction Results 

It is important to note that the BIT instruction when used in immediate 
mode (opcode $89) leaves processor status register bits 7 (N) and 6 (V) 
unchanged on the 65C02. On the 6502, all modes of the BIT instruction have 
the same effect on the status register: the value of memory bit 7 is placed in 
status bit 7, and memory bit 6 is placed in status bit 6. 

Also note that if the JMP indirect instruction (code $60) references an 
indirect address location that spans a page boundary, the 65C02 fetches the 
high-order byte of the effective address from the first byte of the next page, 
while the 6502 fetches it from the first byte of the current page. For 
example, JMP ($02FF) gets ADL from location $02FF on both processors. 
But on the 65C02, ADH comes from $0300; on the 6502, ADH comes 
from $0200. 



Data Sheet 

The remaining pages of this appendix are copyright 1982, NCR Corporation, 
Dayton, Ohio, and are reprinted with their permission. 
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NCR 



NCR65C02 



- GENERAL DESCRIPTION 



■ PIN CONFIGURATION 



The NCR CMOS 6502 is an 8-bit microprocessor which is soft- 
ware compatible with the NMOS 6502. The NCR65C02 hardware 
interfaces with all 6500 peripherals. The enhancements include 
ten additional instructions, expanded operational codes and 
two new addressing modes. This microprocessor has all of the ad- 
vantages of CMOS technology: low power consumption, increased 
noise immunity and higher reliability. The CMOS 6502 is a low 
power high performance microprocessor with applications in the 
consumer, business, automotive and communications market. 



FEATURES 

Enhanced software performance including 27 additional OP cades 
encompassing ten new instructions and two additional 
addressing modes. 

66 microprocessor instructions. 

15 addressing modes. 

178 operational codes. 

1MHz, 2MhU operation. 
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Operates at frequencies as low 

as 200 Hz for even lower power 

consumption (pseudo -static: stop during ©2 ni 9 n ' 

Compatible with NMOS 6500 series 
microprocessors. 

64 Kbyte addressable memory. 

Interrupt capability. 



■ NCR65C02 BLOCK DIAGRAM 
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Lower power consumption. 
4mA @ 1MHz. 

+5 volt power supply. 

8-bit bidirectional data bus. 

Bus Compatible with M6800. 

Non-maskable interrupt. 

40 pin dual-in-line packaging. 

8-bit parallel processing 

Decimal and binary arithmetic. 

Pipeline architecture. 

Programmable stack pointer. 

Variable length stack. 

Option al int ernal pull ups for 
(RDY, IRQ, 50, NMIand flf3) 



Specifications are subject to 
change without notice. 
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NCR65C02 

■ ABSOLUTE MAXIMUM RATINGS: 



< V DD = 5.0 V + 5%, V ss = V, T A = 0° to + 70°C) 



RATING 


SYMBOL 


VALUE 


UNIT 


SUPPLY VOLTAGE 


V DD 


-0.3 To +7.0 


V 


INPUT VOLTAGE 


Mn 


-0.3 to +7.0 


V 


OPERATING TEMP. 


T A 


to + 70 


°C 


STORAGE TEMP. 


T STG 


-55to+ 150 


°c 



• PIN FUNCTION 



PIN 


FUNCTION 


A0-A15 


Address Bus 


D0-D7 


Data Bus 


IRQ' 


Interrupt Request 


RDY* 


Ready 


Ml. 


Memory Lock 


NM1* 


Non-Maskable Interrupt 


SYNC 


Synchronize 


ffK* 


Reset 


55* 


Set Overflow 


NC 


No Connection 


R/W 


Read/Write 


VDD 


Power Supply (+5V) 


VSS 


Internal Logic Ground 


00 


Clock Input 


01, 02 


Clock Output 



'This pin has an optional internal pullup tor a Mo Connect condition. 



> DC CHARACTERISTICS 





SYMBOL 


NUM. 


TYP. 


MAX 


UNIT 


Input High Voltage 

00 (IN) 
Input High Voltage 

RES, NMl, RDY, IRQ, Data, S.O. 


V|H 


Vss + 24 
V SS * 2.0 


- 


Vdd 


V 
V 


Input Low Voltage 

00 (IN) 

RES, NMl, RDY, IRQ, Data, S.O. 


Vil 


V SS -0.3 


- 


V S s+04 
Vss+0.8 


V 
V 


Input Leakage Current 

(V, N = to 5.25V, Vqd = 5.25V) 
With puilups 
Without puilups 


l|N 


-30 


- 


+30 
+1.0 


fiA 
flA 


Three State (Off State) Input Current 
(V| N = 0.4 to 2.4V. V cc = 5.25V) 
Data Lines 


■tsi 






10 


flA 


Output High Voltage 

(l OH =-100 JiAdc, V DD =4J5V 
SYNC, Data, A0-A15, R/W) 


V H 


V SS + 2.4 






V 


Out Low Voltage 

(l 0L = 1.6mAdc, V 00 = 4.75V 
SYNC, Data, A0-A15, R/W) 


Vol 






Vss + ° 4 


V 


Supply Current f = 1MHz 
Supply Current f = 2MHz 


'do 

Idd 


_ 


_ 


4 

8 


mA 
mA 


Capacitance 

(V, N =0, T A =25°C, f = 1MHz) 

Logic 

Data 

A0-A15, R/W, SYNC 

00 (IN) 


C 

G)N 

Cout 
CBq(IN) 


- 


- 


5 

10 
10 
10 


pF 
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NCR65C02 

■ TIMING DIAGRAM 
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Note; All timing is referenced from a high voltage of 2.0 volts and a low voltage of 0.8 volts. 
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• NEW INSTRUCTION MNEMONICS 



HEX 


MNEMONIC 


80 


BRA 


3A 


DEA 


1 A 


INA 


DA 


PHX 


DA 


PHY 


FA 


PLX 


7A 


PLY 


SC 


STZ 


9E 


STZ 


64 


STZ 


74 


STZ 


1C 


TRB 


14 


TRB 


oc 


TSB 


M 


TSB 


ITIONAL 

HEX 


INSTRUCTIC 

MNEMONIC 


72 


ADC 


32 


AND 


3C 


BIT 


34 


BIT 


D2 


CMP 


52 


EOR 


7C 


JMP 


B2 


LDA 


12 


OR A 


F2 


SBC 


92 


STA 



DESCRIPTION 

Branch relative always [Relative] 

Decrement accumulator [Accum] 

Increment accumulator [Accum] 

Push X on stack [Implied] 

Push Y on stack [Implied] 

Pull X from stack [Implied] 

Pull Y from stack [Implied] 

Store zero [Absolute] 

Store zero [ABS, X] 

Store zero [Zero page] 

Store zero [ZPG.X] 

Test and reset memory bits with accumulator [Absolute] 

Test and reset memory bits with accumulator [Zero page] 

Test and set memory bits with accumulator [Absolute] 

Test and set memory bits with accumulator [Zero page] 



DESCRIPTION 

Add memory to accumulator with carry |{ZPG)] 

"AND" memory with accumulator [(ZPG)] 

Test memory bits with accumulator [ABS, X] 

Test memory bits with accumulator [ZPG, X] 

Compare memory and accumulator [(ZPG) ] 

"Exclusive Or" memory with accumulator [(ZPG}] 

Jump (New addressing mode) [ABS(IND,X)1 

Load accumulator with memory [(ZPG)] 

"OR" memory with accumulator [[ZPG)] 

Subtract memory from accumulator with borrow [(ZPG)] 

Store accumulator in memory [(ZPG)] 
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NCR65C02 



i MICROPROCESSOR PROGRAMMING MODEL 



| ACCUMULATOR A 



~] INDEX REGISTER Y 



7 

My|i I b I o I i |z|c| |^essoh STATUS 



J INDEX REGISTER X 

_| PROGRAM COUNTER PC 



I STACK POINTER S 



-CARRY 1 -TRUE 
-ZERO 1 ■ RESULT ZERO 

- fS3 DISABLE t - DISABLE 
•DECIMAL MODE 1 -TRUE 

- BRK COMMAND 1 - BRK 
■OVERFLOW 1 'TRUE 
■NEGATIVE 1 *NEG 



FUNCTIONAL DESCRIPTION 



Timing Control 

The timing control unit keeps track of the instruction 
cycle being monitored. The unit is set to zero each time 
an instruction fetch is executed and is advanced at the 
beginning of each phase one clock pulse for as many 
cycles as is required to complete the instruction. Each 
data transfer which takes place between the registers de- 
pends upon decoding the contents of both the instruc- 
tion register and the timing control unit. 

Program Counter 

The 16-bit program counter provides the addresses which 
step the microprocessor through sequential instructions 
in a program. 

Each time the microprocessor fetches an instruction 
from program memory, the lower byte of the program 
counter (PCD is placed on the low-ordet bits of the 
address bus and the higher byte of the program counter 
(PCH) is placed on the high-order 8 bits. The counter is 
incremented each time an instruction or data is fetched 
from program memory. 

Instruction Register and Decode 

Instructions fetched from memory are gated onto the 
internal data bus. These instructions are latched into the 
instruction register, then decoded, along with timing and 
interrupt signals, to generate control signals tor the var- 
ious registers, 

Arithmetic and Logic Unit (ALU) 

All arithmetic and logic operations take place in the 
ALU including incrementing and decrementing internal 
registers (except the program counter). The ALU has no 
internal memory and is used only to perform logical and 
transient numerical operations. 



Accumulator 

The accumulator is a general purpose 8-bit register that 
stores the results of most arithmetic and logic operations, 
and in addition, the accumulator usually contains one of 
the two data words used in these operations. 

Index Registers 

There are two 8-bit index registers (X and Y), which 
may be used to count program steps or to provide an 
index value to be used in generating an effective address. 

When executing an instruction which specifies indexed 
addressing, the CPU fetches the op code and the base 
address, and modifies the address by adding the index 
register to it prior to performing the desired operation. 
Pre- or post-indexing of indirect addresses is possible (see 
addressing modes). 

Stack Pointer 

The stack pointer is an 8-bit register used to control the 
addressing of the variable-length stack on page one. The 
stack pointer is automatically incremented and decre- 
mented under control of the microprocessor to perform 
stack manipula tion s unde r dir ection of either the program 
or interrupts (NMI and IRQ). The stack allows simple 
implementation of nested subroutines and multiple level 
interrupts. The stack pointer should be initialized before 
any interrupts or stack operations occur. 

Processor Status Register 

The 8-bit processor status register contains seven status 
flags. Some of the flags are controlled by the program, 
others may be controlled both by the program and the 
CPU. The 6500 instruction set contains a number of 
conditional branch instructions which are designed to 
allow testing of these flags (see microprocessor program- 
ming model). 
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NCR65C02 
■ AC CHARACTERISTICS v DD = 5.ovt 5%, t a = o°c to 7o°c Load = i ttl + 130 pF 






1MHZ 


2Mhz 


3MHZ 




Parameter 


Symbol 


Min 


Max 


Min 


Max 


Min 


Max 


Unit 


Delay Time, 0o (IN) to 02 (OUT) 


*DLY 


- 


60 


- 


60 


20 


60 


nS 


Delay Time, 01 (OUT) to 02 (OUT) 


*OLY1 


-20 


20 


-20 


20 


-20 


20 


nS 


Cycle Time 


*CYC 


1.0 


5000* 


0.50 


5000* 


0.33 


5000* 


flS 


Clock Pulse Width Low 


tPL 


460 


- 


220 


- 


160 


- 


nS 


Clock Pulse Width High 


tpH 


460 


- 


220 


- 


160 


- 


nS 


Fall Time, Rise Time 


t F ,t R 


- 


25 


- 


25 


- 


25 


nS 


Address Hold Time 


Uh 


20 


- 


20 


- 





- 


nS 


Address Setup Time 


tADS 


- 


225 


- 


140 


- 


110 


nS 


Access Time 


*ACC 


650 


- 


310 


- 


170 


- 


nS 


Read Data Hold Time 


tDHR 


10 


- 


10 


- 


10 


- 


nS 


Read Data Setup Time 


tDSU 


100 


- 


60 


- 


60 


- 


nS 


Write Data Delay Time 


tMDS 


- 


30 


- 


30 


- 


30 


nS 


Write Data Hold Time 


^DHW 


20 


- 


20 


- 


15 


- 


nS 


S"0~ Setup Time 


tso 


100 


- 


100 


- 


100 


- 


nS 


Processor Control Setup Time** 


Vcs 


200 


- 


150 


- 


150 


- 


nS 


SYNC Setup Time 


tsYNC 


- 


225 


- 


140 


- 


100 


nS 


ML Setup Time 


*ML 


- 


225 


- 


140 


- 


100 


nS 


Input Clock Rise/Fall Time 


*F0o,*R(ki 


- 


25 


- 


25 


- 


25 


nS 



*NCR65C02 can be held static with 
"This parameter must only be met 



02 hi 9 h - 

to guarantee that the signal will be recognized at the current clock cycle. 



■ MICROPROCESSOR OPERATIONAL ENHANCEMENTS 



Function 


NMOS 6502 Microprocessor 


NCR65C02 Microprocessor 


Indexed addressing across page boundary. 


Extra read of invalid address. 


Extra read of last instruction byte. 


Execution of invalid op codes. 


Some terminate only by reset. Results 


All are NOPs {reserved for future use). 




are undefined. 


Op Code Bytes Cycles 
X2 2 2 
X3, X7, XB, XF 1 1 
44 2 3 
54, D4, F4 2 4 
5C 3 8 
DC, FC 3 4 


Jump indirect, operand = XXFF. 


Page address does not increment. 


Page address increments and adds one 
additional cycle. 


Read/modify/write instructions at 


One read and two write cycles. 


Two read and one write cycie. 


effective address. 






Decimal flag. 


Indeterminate after reset. 


Initialized to binary mode (D=0) after 
reset and interrupts, 


Flags after decimal operation. 


Invalid N, V and Z flags. 


Valid flag adds one additional cycle. 


Interrupt after fetch of BRK instruc- 


Interrupt vector is loaded, BRK vector 


BRK is executed, then interrupt is 


tion. 


is ignored. 


executed. 



■ MICROPROCESSOR HARDWARE ENHANCEMENTS 



Function 


NMOS 6502 


NCR65C02 


Assertion of Ready RDY during 
write operations. 


Ignored. 


Stops processor during 02- 


Unused input only pins (IKD, NMI, 
ROY, RF3", S3). 


Must be connected to low impedance 
signal to avoid noise problems. 


Connected internally by a high- 
resistance to Vqd (approximately 250 
K ohm.) 
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Appendix A: The 65C02 Microprocessor 



NCR65C02 

• ADDRESSING MODES 

Fifteen addressing modes are available to the user of the 
NCR65C02 microprocessor. The addressing modes are 
described in the following paragraphs: 

Implied Addressing [Implied! 

In the implied addressing mode, the address containing 
the operand is implicitly stated in the operation code of 
the instruction. 

Accumulator Addressing [Accum) 

This form of addressing is represented with a one byte 
instruction and implies an operation on the accumu- 
lator. 

Immediate Addressing [Immediate] 

With immediate addressing, the operand is contained in 
the second byte of the instruction; no further memory 
addressing is required. 

Absolute Addressing [Absolute) 

For absolute addressing, the second byte of the instruc- 
tion specifies the eight low-order bits of the effective 
address, while the third byte specifies the eight high-order 
bits. Therefore, this addressing mode allows access to the 
total 64K bytes of addressable memory. 

Zero Page Addressing [Zero Page] 

Zero page addressing allows shorter code and execution 
times by only fetching the second byte of the instruction 
and assuming a zero high address byte. The careful use 
of zero page addressing can result in significant increase 
in code efficiency. 

Absolute Indexed Addressing [ ABS, X or ABS, Y| 
Absolute indexed addressing is used in conjunction with 
X or Y index register and is referred to as "Absolute, X," 
and "Absolute, Y." The effective address is formed by 
adding the contents of X or Y to the address contained 
in the second and third bytes of the instruction. This 
mode allows the index register to contain the index or 
count value and the instruction to contain the base 
address. This type of indexing allows any location refer- 
encing and the index to modify multiple fields, resulting 
in reduced coding and execution time, 

Zero Page Indexed Addressing (ZPG, X or ZPG. Y] 

Zero page absolute addressing is used in conjunction 
with the index register and is referred to as "Zero Page, 
X" or "Zero Page, Y," The effective address is calculated 
by adding the second byte to the contents of the index 
register. Since this is a form of "Zero Page" addressing, 
the content of the second byte references a location in 
page zero. Additionally, due to the "Zero Page" address- 
ing nature of this mode, no carry is added to the high- 
order eight bits of memory, and crossing of page boun- 
daries does not occur, 

Relative Addressing [Relative] 

Relative addressing is used only with branch instructions; 



it establishes a destination for the conditional branch. 
The second byte of the instruction becomes the operand 
which is an "Offset" added to the contents of the pro- 
gram counter when the counter is set at the next in- 
struction. The range of the offset is -128 to +127 
bytes from the next instruction, 
Zero Page Indexed Indirect Addressing i (ND, X)! 
With zero page indexed indirect addres 1 ng [usually re- 
ferred to as indirect X ) the second byte o* \'he instruction 
is added to the contents of the X index register; the 
carry is discarded. The result of this addition points to a 
memory location on page zero whose contents is the low- 
order eight bits of the effective address. The next mem- 
ory location in page zero contains the high-order eight 
bits of the effective address. Both memory locations 
specifying the high- and low-order bytes of the effective 
address must be in page zero. 

•Absolute Indexed Indirect Addressing [ABSlIND, X)) 
(Jump Instruction Only) 

With absolute indexed indirect addressing the contents of 
the second and third instruction bytes are added to the 
X register. The result of this addition points to a memory 
location containing the lower-order eight bits of the 
effective address. The next memory location contains 
the higher-order eight bits of the effective address. 

Indirect Indexed Addressing [(IND), Y] 

This form of addressing is usually referred to as Indirect, 
Y. The second byte of the instruction points to a mem- 
ory location in page zero. The contents of this memory 
location are added to the contents of the Y index regis- 
ter, the result being the low-order eight bits of the effec- 
tive address. The carry from this addition is added to the 
contents of the next page zero memory location, the 
result being the high-order eight bits of the effective 
address. 

•Zero Page Indirect Addressing ((ZPG)] 
In the zero page indirect addressing mode, the second 
byte of the instruction points to a memory location on 
page zero containing the low-order byte of the effective 
address. The next location on page zero contains the 
high -order byte of the effective address. 

Absolute Indirect Addressing [(ABS)] 
(Jump Instruction Only) 

The second byte of the instruction contains the low-order 
eight bits of a memory location. The high-order eight 
bits of that memory location is contained in the third 
byte of the instruction. The contents of the fully speci- 
fied memory location is the low-order byte of the effec- 
tive address. The next memory location contains the 
high-order byte of the effective address which is loaded 
into the 16 bit program counter. 



NOTE: 



New Address Modes 
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■ SIGNAL DESCRIPTION 

Address Bus (A0-A1 5} 

A0-A15 forms a 16-bit address bus for memory and I/O 
exchanges on the data bus. The output of each address 
line is TTL compatible, capable of driving one standard 
TTL load and 130pF. 

Clocks {0Q. 01. and 0;) 

0q is a TTL level input that is used to generate ihe inter- 
nal clocks in the 6502. Two full level output clocks are 
generated by the 6502. The 0j clock output Is in phase 
with 0rj- Tne 01 output pin is 180° out of phase with 0q. 
(See timing diagram.) 

Data Bus (O0-O7) 

The data lines (D0-D7) constitute an 8-bii bidirectional 
data bus used for data exchanges to and from the device 
and peripherals. The outputs are three-state buffers 
capable of driving one TTL load and 130 pF. 

Interrupt Request (IRQ) 

This TTL compatible input requests that an interrupt 
sequence begin within the microprocessor. The IRQ. is 
sampled during 02 operation; if the interrupt flag in the 
processor status register is zero, the current instruction 
is completed and the interrupt sequence begins during 
01. The program counter and processor siatus register 
are stored in the stack. The microprocessor will th en set 
the interrupt mask flag high so that no further IRQs 
may occur. At the end of this cycle, the program counter 
jow will be loaded from address FFFE, and program 
counter high from location FFFF, transferring program 
control to the memory vector located at these addresses. 
The RDY signal must be in the high state for any inter- 
rupt to be recognized. A 3K ohm external resistor should 
be used for proper wire OR operation. 

Memory Lock I ML) 

In a multiprocessor system, the M~L output indicates the 
need to defer the rearbitration of the next bus cycle to 
ensure the integrity of read -modify -write instructions, 
ML goes low during ASL. DEC, INC, LSR, ROL, ROR, 
TRB, TSB memory referencing instructions. This signal 
is low for the modify and write cycles. 

Non-Maskable Interrupt (NMII 

A negative-gotng edge on this input requests that a non- 
maskable interrupt sequ ence be generated within the 
microprocessor. The NMI is sampled during 02; the cur- 
rent instruction is completed and the interrupt sequence 
begins during 01. The program counter is loaded with 
the interrupt vector from locations FFFA (low byte) 
and FFFB (high byte), thereby transferring program con- 
trol to the non-maskable interrupt routine. 



NCR65C02 



Ready (RDY) 

This input allows the user to single-cycle the micropro- 
cessor on all cycles including write cycles. A negative 
transition to the low state, during or coincident with 
phase one (0-|), will halt the microprocessor with the out- 
put address lines reflecting the current address being 
fetched. This condition will remain through a subsequent 
phase two (02) in which the ready signal is low, This fea- 
ture allows microprocessor interfacing with low-speed 
memory as well as direct memory access (DMA), 

Reset (RES) 

This input is used to reset the microprocessor. Reset 
must be held low for at least two clock cycles after 
VDO reaches operating voltage from a power down. A 
positive transistion on this pin will then cause an initiali- 
zation sequence to begin. Likewise, after the system has 
been operating, a low on this line of at least two cycles 
will cease microprocessing activi ty, f ollowed by initial- 
ization after the positive edge on RES. 

When a positive edge is detected, there is an initialization 
sequence lasting six clock cycles. Then the interrupt 
mask flag is set, the decimal mode is cleared, and the pro- 
gram counter is loaded with the restart vector from loca- 
tions FFFC (low byte) and FFFD (high byte), This is 
the start location for program control. This input should 
be high in normal operation. 

Read .Write (R/W! 

This signal is normally in the high state indicating that 

the microprocessor is reading data from memory or I/O 

bus. In the low state the data bus has valid data from the 

microprocessor to be stored at the addressed memory 

location. 

Set Overflow (SO) 

A negative transition on this line sets the overflow bit in 
the status code register. The signal is sampled on the trail- 
ing edge of 0]. 

Synchronize (SYNC) 

This output line is provided to identify those cycles dur- 
ing which the microprocessor is doing an OP CODE 
fetch. The SYNC line goes high during 0^ of an OP CODE 
fetch and stays high for the remainder of that cycle. If 
the RDY line is pulled low during the 0) clock pulse in 
which SYNC went high, the processor will stop in its 
current state and will remain in the state until the RDY 
line goes high. In this manner, the SYNC signal can be 
used to control RDY to cause single instruction execu- 
tion, 



Note: Since this interrupt is non-maskable, another NMI 
can occur b efore the first is finished. Care should be taken 
when using NM I to avoid this. 
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NCR65C02 

* INSTRUCTION SET — ALPHABETICAL SEQUENCE 



ADC Add Memory lo Accumulator with Carry 

AND "AND" Memory with Accumulator 

ASL Shift One Bit Left 

BCC Branch on Carry Clear 

BCS Branch on Carry Set 

BEQ Branch an Result Zero 

BIT Test Memory Bits with Accumulator 

BMI Branch on Result Minus 

BNE Branch on Result not Zero 

BPL Branch on Result Plus 

'BRA Branch Always 

BRK Force Break 

BVC Branch on Overflow Clear 

BVS Branch on Overflow Set 

CLC Clear Carry Flag 

CLD Clear Decimal Mode 

CLI Clear InterruptDisabie Bit 

CLV Clear Overflow Flag 

CMP Compare Memory and Accumulator 

CPX Compare Memory and Index X 

CPV Compare Memory and Index Y 

* DEA Decrement Accumulator 
DEC Decrement by One 

DEX Decrement Index X by One 

DEV Decrement Index Y by One 

EOR "Exclusive- or" Memory with Accumulator 

* INA Increment Accumulator 
INC Increment by One 

I NX Increment Index X by One 

INY Increment Index Y by One 

JMP Jump to New Location 

JSR Jump to New Location Saving Return Address 

LDA Load Accumulator with Memory 

Note: * ■ New Instruction 

• MICROPROCESSOR OP CODE TABLE 



LDX Load Index X with Memory 

LDY Load Index Y with Memory 

LSR Shift One Bit Right 

NOP No Operation 

ORA "OR" Memory with Accumulator 

PHA Push Accumulator on Stack 

PHP Push Processor Status on Stack 

■PHX Push Index X on Stack 

1 PHY Push Index Y on Stack 

PLA Pull Accumulator from Stack 

PLP Pull Processor Status from Stack 

' PLX Pull Index X from Stack 

•PLY Pull Index Y from Stack 

ROL Rotate One Bit Left 

FtOR Rotate One Bit Right 

RTI Return from Interrupt 

RTS Return from Subroutine 

SBC Subtract Memory from Accumulator with Borrow 

SEC Set Carry Flag 

SED Set Decimal Mode 

SEI Set Interrupt Disable Bit 

STA. Store Accumulator in Memory 

STX Store Index X in Memory 

STY Store Index Y in Memory 

' STZ Store Zero in Memory 

TAX Transfer Accumulator lo Index X 

TAY Transfer Accumulator to I ndex Y 

' TRB Test and Reset Memory Bits with Accumulator 

' TSB Test and Set Memory Bits with Accumulator 

TSX Transfer Stack Pointer to Index X 

TXA Transfer Index X to Accumulator 

TXS Transfer Index X to Stack Pointer 

TYA Transfer Index Y to Accumulator 



S 

D 





1 


2 


3 


4 


5 


6 


7 


5 


9 


A, 


B 


C 


D 


E 


F 







BRK 


ORA 
ind, X 






TSB* 

zpg 


ORA 
ZP9 


ASL 
ZP9 




PHP 


ORA 

imm 


ASL 

A 




TSB* 
abs 


ORA 


ASL 
abs 







t 


BPL 

rel 


ORA 

ind, Y 


ORA't 
I zpg I 




TRB* 
zpg 


ORA 

zpg, x 


ASL 

zpg, x 




CLC 


ORA 
abs, Y 


INA* 
A 




TRB" 
abs 


ORA 

abs, X 


ASL 

abs. X 




1 


2 


JSR 
abs 


AND 

ind, X 






BIT 
zpg 


AND 
zpg 


ROL 

zpg 




PLP 


AND 


ROL 
A 




BIT 
abs 


AND 

abs 


ROL 
abs 




2 


3 


BMI 

rel 


AND 
ind, Y 


AND't 

Upg) 




BIT* 
zpg, X 


AND 

zpg, x 


ROL 
zpg, X 




SEC 


AND 
abs, Y 


DEA* 

A 




BIT't 
abs, X 


AND 

abs, X 


ROL 
abs, X 




3 


4 


RTI 


60R 

ind, X 








EOR 
zpg 


LSR 

zpg 




PHA 


EOR 

imm 


LSR 
A 




JMP 
abs 


EOR 
abs 


LSR 

abs 




4 


S 


BVC 
rel 


EOR 
ind, Y 


EOR't 
IspOJ 






EOR 

zpg. x 


LSR 
zpg, X 




CLI 


EOR 

abs, Y 


PHY* 






EOR 
abs. X 


LSR 
abs, X 




5 


6 


RTS 


ADC 

ind. X 






STZ* 
zpg 


ADC 
zpg 


ROR 

zpg 




PLA 


ADC 


ROR 
A 




JMP 
(abs) 


AOC 
abs 


ROR 
abs 




6 


7 


BVS 
rel 


ADC 
md, Y 


ADC't 
(ipgl 




STZ* 
zpg. X 


ADC 
ZP9. X 


ROR 
zpg. x 




SEI 


ADC 
abs, Y 


PLY* 




JMP*t 
abstmd.Xl 


ADC 
abs, X 


ROR 
abs, X 




7 


3 


BRA* 

rel 


STA 
ind, X 






STY 
zpg 


STA 
zpg 


STX 

zpg 




DEY 


BIT* 


TXA 




STY 
abs 


STA 

abs 


STX 
abs 




B 


9 


BCC 

rel 


STA 
ind, Y 


STA't 
(ZP9> 




STY 
ZP9. X 


STA 
ZP9. * 


STX 
zpg. Y 




TYA 


STA 
abs, Y 


TXS 




STZ* 
abs 


STA 
abs, X 


STZ* 

abs, X 




9 


A 


LDY 

imm 


LDA 
ind, X 


LDX 

imm 




LDY 

IPS 


LDA 
zpg 


LDX 

zpg 




TAY 


LDA 

mm 


TAX 




LDY 
abs 


LDA 
abs 


LDX 
abs 




A 


B 


BCS 
rel 


LDA 
ind, Y 


LDA"t 
<zpo> 




LDY 

zpg, x 


LDA 
ZP3. X 


LDX 
zpg. Y 




CLV 


LDA 

abs, Y 


TSX 




LDY 
abs. X 


LDA 
abs X 


LDX 

abs. Y 




B 


C 


CPY 
imm 


CMP 
ind, X 






CPY 

zpg 


CMP 

zpg 


DEC 

ZP9 




INY 


CMP 

mm 


DEX 




CPY 
abs 


CMP 

abs 


DEC 
abs 




C 


D 


BNE 

rel 


CMP 

ind, V 


CMP't 
(zpjl 






CMP 
zpg, X 


DEC 
ZP9,X 




CLD 


CMP 
abs, Y 


PHX" 






CMP 

abs, X 


DEC 
abs, X 




D 


r 


CPX 

imm 


SBC 

md, X 






CPX 
zpg 


SBC 

zpg 


INC 
zpg 




INX 


SBC 

imm 


NOP 




CPX 
abs 


SBC 
abs 


INC 
abs 




E 


: 


BEQ 
ret 


sec 

md, Y 


SBC'T 
(zpg) 






SBC 

zpg, X 


INC 
ZP9. X 




SED 


sac 

abs. Y 


PLX* 






SBC 
abs, X 


INC 
abs, X 




F 





1 


2 


3 


4 


5 


6 


7 


e 


9 


A 


B 


C 


D 


E 


F 





Sote * = New OP Codes 

t ■ New Address Modes 
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OPERATIONAL CODES, EXECUTION TIME, AND MEMORY 
REQUIREMENTS 



NCR65C02 







IMME 
DIATE 


ABSO 
LUTE 


ZERO 
PACE 


ACCOM 


IM- 
PLIED 


iIND 
XI 


IIND], 
¥ 


ZPG, X 


ZPG. Y 


a as. x 


ABS,Y 


rela- 
tive: 


IABS) 


ABB 
HMD, X) 


IZPCI 


PROCESSOR 
STATUS COOES 


MNE 


OPERATION 


OP 




* 


■Of- 


„ 


# 


Br 


„ 


r 


DP 


n 


» 


■» 


n 


* 


OP 


n 


If 


OP 


n 


# 


OP 




' 


OP 




f 


OP 




r 


:>-' 


n 


IIOF 




f 


OP 




1 


OP 


n 


> 


OP 


„ 


p 


7 6 5 4 3 2 10 


MNE 


N V . I | 


ADC 
ANC 

ASL 

sec 

F3CS 


A*M*C-A 11.31 
A A M» A 11] 


35 
29 


2 


2 
2 


60 
20 
3E 


4 
4 

6 


:. 
3 
3 


FA 
35 
06 


3 
J 
5 


2 
2 
2 


OA 


: 


1 








61 
21 


• 

4 


2 
2 


21 
31 


a 


2 
3 


75 
35 
16 


4 
4 
6 


2 

2 
2 








70 
30 
IE 


4 
4 
S 


j 

3 
3 


79 


4 
< 


: 


2 
2 


3 

? 














12 
32 


t 


2 

2 


N , . . 
N , , , 


. . zc 

. z . 
z c 


ADC 
AND 
ASL 
■CC 

ecs 


«Wl «-° 111 
flrinch .r C-Q HI 

Branch it c-1 <2> 




H 


bed. 

BIT 

BMl 
3NE 
FJPL 


B^.nsh.lZ.I (2) 
A AM (4.51 
Brinth rt N»1 Ul 
Br4n<* it Z-0. 4.2I 
Brinch it N=0 (21 


Bfl 


2 


2 


2C 


4 


3 


24 


3 


2 


























34 


4 


2 








3C 


4 


3 








FO 

30 
DO 

'0 


2 

1 

2 
2 


2 

2 

2 
2 




















*f*t, ■ 


. . z , 


BEQ 

BIT 
BMl 
BNE 
BPL 


BRA 

e-VC 

avs 
etc 


Briiteh Arwiyi (21 

Br«»k 

Brinch if V=0 (31 

B-i.rtJVil (2J 

o«c 


























00 


7 
3 


l 
1 






































ao 

50 
70 


2 

2 
2 


2 

2 

2 






















1 . 


BRA 
BRK 
BVC 

BVS 

clc 




- 

- - - d 


CLD 
CLI 
C L ■-. 
CMP 
CPX 


O'l 

o-v 

AM (11 
X M 


C9 
60 


2 

2 


2 

? 


CO 

(EL 


4 

4 


3 
3 


C5 
EJ 


3 

3 


2 








DE- 

M 

aa 


} 

: 

2 


! 
1 
1 


CI 


e 


2 


01 


5 


I 


M 


4 


3f 








oo 


4 


3 


09 


4 


3 




















D2 


5 


2 





.0 

N . . 2 C 
N Z C 


CLD 
CLI 
CLV 
CMP 
CPX 


CPY 
DEA 
DEC 
DSX 
DEY 


y ■ m 

A ■ 1 • A 

M 1 * M (|| 

X - 1 • X. 

r- i«y 


CO 


2 


2 




4 
I 


-■ 

2 


04 


3 

5 


2 
2 


:■* 


2 


' 


CA 


I 
1 


1 
■ 














D6 


6 


2 








HE 


6 


3 
























N Z C 

N . . Z . 
41 Z 
N Z . 
N Z 


CPY 
OEA 
OEC 

DEX 
Of V 


edh 

ISA 
HVC 

INX 
INV 


A V M*A 

A ♦ I *A 

M* l »M III 

X * 1 -X 

Y • 1 - Y 


J9 


J 


3 


40 
EE 


A 
6 


3 
3 


45 

E6 


i 

i 


2 

2 


1A 


2 


I 


EE 


2 
3 


1 
1 


4' 


6 


2 


5 


B 


2 


F6 


4 
6 


3 
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Notes 
1. 

2. 

3. 

4. 



Acid 1 to JJ n" if page boundary is crossed. 

Add \ to "n M i* branch occufs to same page 

Add 2 to "n" i1 branch occurs tD different page 

Add 1 to "n" if decimal mode. 

V bit equals memory bit 6 prior to execution. 

N bit equals memory bit 7 prior to execution. 

The immediate addressing mode of the BIT instruction leaves bits 6 & 7 

IV & Nl in the Processor Status Code Register unchanged. 



X Index X 

Y Index Y 

A Accumulator 

M Memory per effective address 

Ms Memory per stack painter 



+ Add 

- Subtract 

A And 

V Or 

-V- Exclusive or 



n No. Cycles 
* No. Bytes 
Mg Memory bit 6 
M7 Memory bit 7 
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▲Warning 



Here is a list of useful subroutines in the Apple He's Monitor. To use these 
subroutines from machine-language programs, store data into the specified 
memory locations or microprocessor registers as required by the subroutine 
and execute a JSR to the subroutine's starting address. After the subroutine 
performs its function, it returns with the 65C02's registers changed as 
described, 

For the sake of compatibility between the Apple II Plus, Apple lie. and 
the Apple lie, do not jump into the middle of Monitor subroutines. The 
starting addresses are the same for all models of the Apple II, but the 
actual code is different, 



BASICIN Read the keyboard 



SC305 



When the 80-column firmware is active, BASICIN is used instead of KEYIN. 
BASICIN operates like KEYIN except that it displays a solid, non-blinking 
cursor instead of a blinking checkerboard cursor. 



BASICOUT Output to screen 



SC307 



When the 80-column firmware is active, BASICOUT is used instead of 
COUT1. BASICOUT displays the character in the accumulator on the 
Apple He's screen at the current output cursor position and advances the 
output cursor. It places the character using the setting of the 
Normal/Inverse location. It handles control codes; see Table 3-3b. 
BASICOUT returns with all registers intact. 



BELL 



Output a bell character 



SFF3A 



BELL writes a bell (Control-G) character to the current output device. It 
leaves the accumulator holding $87. 



BELLI 



Sends a beep to the speaker 



$FBDD 



BELLI generates a 1 kHz tone in the Apple He's speaker for 0. 1 second. It 
scrambles the A and X registers. 



CLREOL Clear to end of line 



SFC9C 



CLREOL clears a text line from the cursor position to the right edge of the 
window. CLREOL destroys the contents of A and Y. 
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CLEOLZ Clear to end of line 



$FC9E 



CLEOLZ clears a text line to the right edge of the window, starting at the 
location given by base address BASL, which is indexed by the contents of 
the Y register. CLEOLZ destroys the contents of A and Y. 



CLREOP Clear to end of window 



$FC42 



CLREOP clears the text window from the cursor position to the bottom of 
the window. CLREOP destroys the contents of A and Y. 



CLRSCR Clear the low-resolution screen 



$F832 



CLRSCR clears the low-resolution graphics display to black. If you call 
CLRSCR while the video display is in text mode, it fills the screen with 
inverse-mode at-sign (@) characters. CLRSCR destroys the contents of A 
andY. 

CLRTOP Clear the low-resolution screen $F836 

CLRTOP is the same as CLRSCR (above), except that it clears only the top 
40 rows of the low -resolution display. 



COUT 



Output a character 



SFDED 



COUT calls the current character output subroutine. The character to be 
output should be in the accumulator. COUT calls the subroutine whose 
address is stored in CSW (locations $36 and $37), which is usually one of 
the standard character output subroutines, COUT1 or BASICOUT. 



COUT1 Output to screen 



SFDFO 



COUT1 displays the character in the accumulator on the Apple He's screen 
at the current output cursor position and advances the output cursor. It 
places the character using the setting of the Normal/Inverse location. It 
handles the codes for carriage return, linefeed, backspace, and bell. It 
returns with all registers intact. 

CROUT Generate a carriage return character $FD8E 

GROUT sends a carriage return character to the current output device. 



CROUT1 Generate carriage return, clear rest of line 



$FD8B 



CROUT 1 clears the screen from the current cursor position to the edge of 
the text window, then calls CROUT. 
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GETLN Get an input line with prompt 



$FD6A 



GETLN is the standard input subroutine for entire lines of characters, as 
described in Chapter 3. Your program calls GETLN with the prompt 
character in location $33; GETLN returns with the input line in the input 
buffer (beginning at location $0200) and the X register holding the length of 
the input line. 



GETLNZ Get an input line 



SFD67 



GETLNZ is an alternate entry point for GETLN that sends a carriage return 
to the standard output, then continues into GETLN. 



GETLN 1 Get an input line, no prompt 



$FD6F 



GETLN1 is an alternate entry point for GETLN that does not issue a prompt 
before it accepts the input line. If, however, the user cancels the input line, 
either with too many backspaces or with a l control j -fxH, then GETLN1 
will issue the contents of location $33 as a prompt when it gets another line. 



HLINE 



Draw a horizontal line of blocks 



SF819 



HLINE draws a horizontal line of blocks of the color set by SETCOL on the 
low-resolution graphics display. Call HLINE with the vertical coordinate of 
the line in the accumulator, the leftmost horizontal coordinate in the 
Y register, and the rightmost horizontal coordinate in location $2C. HLINE 
returns with A and Y scrambled, X intact. 



HOME 



Home cursor and clear 



$FC58 



HOME clears the display and puts the cursor in the home position: the 
upper-left corner of the screen. 



IOREST Restore all registers 



SFF3F 



IOREST loads the 65C02's internal registers with the contents of memory 
locations $45 through $49. 



IOSAVE Save all registers 



SFF4A 



IOSAVE stores the contents of the 65C02's internal registers in locations $45 
through $49 in the order A, X, Y, P, S, The contents of A and X are changed 
and the decimal mode is cleared. 
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KEYIN Read the keyboard 



$FD1B 



KEYIN is the keyboard input subroutine. It reads the Apple He's keyboard, 
waits for a keypress, and randomizes the random number seed at $4E-$4F, 
When a key is pressed, KEYIN removes the blinking cursor from the display 
and returns with the keycode in the accumulator. KEYIN is described in 
Chapter 3. 



MOVE 



Move a block of memory 



SFE2C 



MOVE copies the contents of memory from one range of locations to 
another. This subroutine is the same as the MOVE command in the Monitor, 
except that it takes its arguments from pairs of locations in memory, 
low-byte first. The destination address must be in A4 ($42-§43), the starting 
source address in Al ($3C-$3D), and the ending source address in A2 
(S3E-$3F) when your program calls MOVE. Register Y must contain $00 
when your program calls MOVE. 



NEXTCOL Increment color by 3 

NEXTCOL adds 3 to the current color (set by SETCOL) used for 
low-resolution graphics. 



$F85F 



PLOT 



Plot on the low-resolution screen 



SF800 



PLOT puts a single block of the color value set by SETCOL on the 
low-resolution display screen. The block's vertical position is passed in the 
accumulator, its horizontal position in the Y register. PLOT returns with the 
accumulator scrambled, but X and Y intact. 



PRBLNK Print three spaces 



$F948 



PRBLNK outputs three blank spaces to the standard output device. On 
return, the accumulator usually contains SAO, the X register contains 0. 

PRBL2 Print many blank spaces $F94A 

PRBL2 outputs from 1 to 256 blanks to the standard output device. Upon 
entry, the X register should contain the number of blanks to be output. If 
X=$00, then PRBL2 will output 256 blanks. 



PRBYTE Print a hexadecimal bvte 



SFDDA 



PRBYTE outputs the contents of the accumulator in hexadecimal on the 
current output device. The contents of the accumulator are scrambled. 
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PREAD 



Read a hand control 



$FB1E 



PREAD returns a number that represents the position of a hand control. You 
pass the number of the hand control in the X register. If this number is not 
valid (not equal to 0, 1, 2, or 3), strange things may happen. PREAD returns 
with a number from $00 to $FF in the Y register. The accumulator is 
scrambled. 



■ 



PRERR 



Print ERR 



$FF2D 



PRERR sends the word ERR, followed by a bell character, to the standard 
output device. On return, the accumulator is scrambled. 



PRHEX Print a hexadecimal digit 



$FDE3 



PRHEX prints the lower nibble of the accumulator as a single hexadecimal 
digit. On return, the contents of the accumulator are scrambled. 



PENT AX Print A and X in hexadecimal 



$F941 



PRNTAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte output, the X 
register contains the second. On return, the contents of the accumulator are 
scrambled. 



RDCHAR Get an input character or escape code 



$FD35 



RDCHAR is an alternate input subroutine that gets characters from the 
standard input subroutine, and also interprets the escape codes listed in 
Chapter 3. 



RDKEY Get an input character 



SFDOC 



RDKEY is the character input subroutine. It places a blinking cursor on the 
display at the cursor position and jumps to the subroutine whose address is 
stored in KSW (locations $38 and $39), usually the standard input 
subroutine KEYIN, which returns with a character in the accumulator, 



READ 



Read a record from a cassette 



$FEFD 



READ reads a series of tones at the cassette input port, converts them to 
data bytes, and stores the data in a specified range of memory locations. 
Before calling READ, the address of the first byte must be in A 1 ($3C-$3D) 
and the address of the last byte must be in A2 ($3E-$3F). 
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READ keeps a running exclusive-OR of the data bytes in CHKSUM ($2E). 
When the last memory location has been filled, READ reads one more byte 
and compares it with CHKSUM. If they are equal, READ sends out a beep 
and returns; if not, it sends the string ERR through COUT, sends the beep, 
and returns. 



SCRN 



Read the low-resolution graphics screen 



$F871 



SCRN returns the color value of a single block on the low-resolution 
graphics display. Call it with the vertical position of the block in the 
accumulator and the horizontal position in the Y register. Call it as you 
would call PLOT (above). The color of the block will be returned in the 
accumulator, No other registers are changed. 



SETCOL Set low-resolution graphics color 



$F864 



SETCOL sets the color used for plotting in low-resolution graphics to the 
value passed in the accumulator. The colors and their values are listed in 
Table 2-6. 



SETINV Set inverse mode 



$FE80 



SETINV sets the dislay format to inverse. COUT1 will then display all 
output characters as black dots on a white background. The Y register is set 
to $3F, all others are unchanged. 



SETNORM Set normal mode 



$FE84 



SETNORM sets the display format to normal. COUT1 will then display all 
output characters as white dots on a black background. On return, the 
Y register is set to $FF, all others are unchanged. 



VERIFY Compare two blocks of memory 



$FE36 



VERIFY compares the contents of one range of memory to another. This 
subroutine is the same as the VERIFY' command in the Monitor, except it 
takes its arguments from pairs of locations in memory, low-byte first. The 
destination address must be in A4 ($42-$43), the starting source address in 
Al ($3C-$3D), and the ending source address in A2 ($3E-$3F) when your 
program calls VERIFY. 
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VLINE 



Draw a vertical line of blocks 



$F828 



VLINE draws a vertical line of blocks of the color set by SETCOL on the 
low-resolution display. You should call VLINE with the horizontal 
coordinate of the line in the Y register, the top vertical coordinate in the 
accumulator, and the bottom vertical coordinate in location $2D. VLINE will 
return with the accumulator scrambled, 



WAIT 



Delay 



$FCA8 



WAIT delays for a specific amount of time, then returns to the program that 
called it, The amount of delay is specified by the contents of the 
accumulator. The delay is l/2(26+27A+5A " 2) microseconds, where A is 
the contents of the accumulator, WAIT returns with the accumulator 
zeroed and the X and Y registers undisturbed, 



WRITE 



Write a record on a cassette 



$FECD 



WRITE converts the data in a range of memory to a series of tones at the 
cassette output port. Before calling WRITE, the address of the first data 
byte must be in Al ($3C-$3D) and the address of the last byte must be in A2 
($3E-$3F). The subroutine writes a ten-second continuous tone as a header, 
then writes the data followed by a one-byte checksum, 
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This appendix lists the differences among the Apple II Plus, the original and 
the enhanced Apple lie, and the Apple lie. 

If you're trying to write software to run on more than one version of the 
Apple II, this appendix will help you avoid unexpected problems of 
incompatibility. 

The differences are listed here in approximately the order you are likely to 
encounter them; obvious differences first, technical details later. Each entry 
in the list includes references to the chapters in this manual where the item 
is described. 



Keyboard 

The Apple lie and Apple lie have a full 62-key uppercase and lowercase 
keyboard. The keyboard includes fully-operational 1 shift | and 
I caps lock] keys. It also includes four directional arrow keys for moving 
the cursor. Chapter 2 includes a description of the keyboard. The 
cursor-motion keys are described in Chapter 3. 



Apple Keys 



The keyboard of the Apple He and Apple Nc have two keys marked with the 
Apple logo. These keys, called the Open-Apple key ([6]) and Solid- Apple 
key ([!]), are used with the | reset I key to select special reset functions. 
They are connected to the buttons on the hand controls, so they can be used 
for special functions in programs. 

The Apple II and the Apple II Plus do not have Apple keys. 



Character Sets 



The Apple He and Apple lie can display the full ASCII character set, 
uppercase and lowercase. For compatibility with older Apple ITs, the 
standard display character set includes flashing uppercase instead of 
inverse-format lowercase; you can also switch to an alternate character set 
with inverse lowercase and uppercase, but no flashing. Chapter 2 includes a 
description of the display character sets. Chapter 3 tells you how to switch 
display formats. 
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The Apple He and the enhanced Apple lie include a set of "graphic" text 
characters, called MouseText characters, that replace some of the inverse 
uppercase characters in the alternate character set of the original Apple He. 
MouseText characters are described in Chapter 2. 



80-Column Display 

With the addition of an 80-column text card, the Apple lie can display 80 
columns of text. The 80-column display is completely compatible with both 
graphics modes— you can even use it in mixed mode. (If you prefer, you can 
use an old-style 80-column card in an expansion slot instead.) Chapter 2 
includes a description of the 80-column display. 

The Apple lie has a built-in extended 80-column card. 



Escape Codes and Control Characters 

On the Apple He and Apple He, the display features mentioned above (and 
many others not mentioned) can be controlled from the keyboard by escape 
sequences and from programs by control characters. Chapter 3 includes 
descriptions of those escape codes and control characters. 



Built-in Language Card 



The 16K bytes of RAM you add to the Apple II Plus by installing the 
Language Card is built into the Apple He and Apple He, giving the Apple He 
a standard memory size of 64K bytes. (The Apple He has a built-in extended 
80-column text card as well, giving it a standard memory size of 128K 
bytes.) In the Apple He, this 16K-byte block of memory is called the 
bank-switched memory. It is described in Chapter 4. 



Built-in Language Card 
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Auxiliary Memory 



By installing the Apple He Extended 80-Column Text Card, you can add an 
alternate 64K bytes of RAM to the Apple He. Chapter 4 tells you how to use 
the additional memory. (The Extended 80-Column Text Card also provides 
the 80-column display option.) 

The Apple lie has a built-in extended 80-column text card. 



Auxiliary Slot 



In addition to the expansion slots on the Apple II Plus, the Apple He has a 
special slot that is used either for the 80-Column Text Card or for the 
Extended 80-Column Text Card. This slot is identified in Chapter 1 and 
described in Chapter 7, 

The Apple lie has the functions of the auxiliary slot built in. 



Back Panel and Connectors 



The Apple He has a metal back panel with space for several D-type 
connectors. Each peripheral card you add comes with a connector that, you 
install in the back panel. Chapter 1 includes a description of the back panel; 
for details, see the installation instructions supplied with the peripheral 
cards. 

The Apple He back panel has seven built-in connectors. 



Soft Switches 



The display and memory features of the Apple He and the Apple lie are 
controlled by soft switches like the ones on the Apple II Plus. On the 
Apple He and the Apple lie, programs can also read the settings of the soft 
switches. Chapter 2 describes the soft switches that control the display- 
features, and Chapter 4 describes the soft switches that control the memory 
features. 
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Built-in Self-Test 



The Apple He has built-in firmware that includes a self-test routine. The 
self-test is intended primarily for testing during manufacturing, but you can 
run it to be sure the Apple He is working correctly. The self-test is described 
in Chapter 4. 



The Apple lie also has built-in diagnostics. 



Forced Reset 



Some programs on the Apple II Plus take control of the reset function to 
keep users from stopping the machine and copying the program. The 
Apple He and Apple lie have a forced reset that writes over the program in 
memory. By using the forced reset, you can restart the Apple He (or 
Apple lie) without turning power off and on and causing unnecessary stress 
on the circuits. The forced reset is described in Chapter 4. 



Interrupt Handling 



Even though most application programs don't use interrupts, the Apple He 
(and Apple He) provide for interrupt-driven programs. For example, the 
80-column firmware periodically enables interrupts while it is clearing the 
display (normally a long time to have interrupts locked out). Interrupts are 
discussed in Chapter 6. 



Vertical Sync for Animators 



Programs with animation on the Apple He and Apple He can stay in step 
with the display and avoid flickering objects in their displays. Chapter 7 
includes a description of the video generation and the vertical sync. 



Vertical Sync For Animators 
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Signature Byte 



A program can find out whether it's running on an Apple He, Apple lie, 
Apple III (in emulation mode), or on an older model Apple II by reading the 
byte at location $FBB3 in the System Monitor, In the Apple He Monitor, this 
byte's value is $06; in the Autostart Monitor (the standard Monitor on the 
Apple II Plus), its value is $EA. (Note: if you start up with DOS and switch 
to Integer BASIC, the Autostart Monitor is active and the value at location 
$FBB3 is $EA, even on an Apple He.) Obviously, there are lots of other 
locations that have different values in the different versions of the Monitor; 
location SFBB3 was chosen because it will have the value $06 even in 
future revisions of the Apple lie Monitor. 



Hardware Implementation 



All of these features are described in 

Chapter 7. 



For more information about the Apple lie, 
see the Apple lie Reference Manual. 



The hardware implementation of the Apple He is radically different from 
the Apple II and Apple II Plus. Three of the more important differences are 

a the custom ICs: the IOU and MMU 

a the video hardware, which uses ROM to generate both text and graphics 

d the peripheral data bus, which is fully buffered. 

The Apple lie 

□ shares some of the custom ICs of the Apple He 

□ has some new ones all its own 

d lacks the slots of the Apple He, replacing some of them with built-in I/O 
ports. 
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This appendix is an overview of the characteristics of operating systems 
and languages when run on the Apple He. It is not intended to be a full 
account. For more information, refer to the manuals that are provided with 
each product. 



Operating Systems 

This section discusses the operating systems that can be used with the 
Apple He. 



ProDOS 

ProDOS is the preferred disk operating system for the Apple He. It supports 
interrupts, startup from drives other than a Disk II, and all other hardware 
and firmware features of the Apple He. 



DOS 3.3 

The Apple He works with DOS 3.3. The Apple lie can also access DOS 3.2 
disks by using the BASICS disk. However, neither version of DOS takes full 
advantage of the features of the Apple He. DOS support is provided only for 
the sake of Apple II series compatibility. 



Pascal Operating System 

The Apple II Pascal operating system was developed from the UCSD Pascal 
system from the University of California at San Diego. While it shares many 
characteristics of that system, it has been extended by Apple in several 
areas. 

Pascal versions 1.2 and later support interrupts and all the hardware and 
firmware features of the Apple He. 

The Apple II Pascal system uses a disk format different than either ProDOS 
or DOS 3.3. 






Appendix 1): Operating Systems and Languages 



CP/M 

CP/M® is an operating system developed by Digital Research that runs on 
either the Intel 8080 or Zilog Z80® microprocessors. This means that a 
co-processor peripheral card, available from several manufacturers for the 
Apple He, is required to run CP/M. Several versions of CP/M from 1.4 
through 3.0 and later can be run on an Apple He with an appropriate 
co-processor card. 



Languages 



This section discusses special techniques to use, and characteristics to be 
aware of, when using Apple programming languages with the Apple lie. 



An aid for assembly-language programming 
is ProDOS Assembler Tools (A2WG013). 



Assembly Language 

Programs written in assembly language have the potential of extracting the 
most speed and efficiency from your Apple He, but they also require the 
most effort on your part. 



Applesoft BASIC 

The focus of the chapters in this manual is assembly language, and so most 
addresses and values are given in hexadecimal notation. Appendix E in this 
manual includes tables to help you convert from hexidecimal to the decimal 
notation you will need for BASIC. 

In BASIC, use a PEEK to read a location (instead of the LDA used in 
assembly language), and a POKE (instead of STA) to write to a location. If 
you read a hardware address from a BASIC program, you get a value 
between and 255. Bit 7 holds a place value of 128, so if a soft switch Is on, 
its value will be equal to or greater than 128; if the switch is off, the value 
will be less than 128. 



Integer BASIC 

Integer BASIC is not included in the Apple He firmware. If you want to run 
it on your Apple he, you must use DOS 3.3 to load it in to the system. 
ProDOS does not support Integer BASIC. 
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Pascal Language 

The Pascal language works on the Apple lie under versions 1.1 and later of 
the Pascal Operating System. However, for best performance, use Pascal 1.2 
or a later version. 



FORTRAN 



FORTRAN works under version 1.1 of the Pascal Operating System which 
does not detect or use certain Apple He features, such as auxiliary memory. 
Therefore, FORTRAN does not take advantage of these features, 
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Appendix E 



Conversion Tables 







This appendix briefly discusses bits and bytes and what they can represent. 
It also contains conversion tables for hexadecimal to decimal and negative 
decimal, for low-resolution display dot patterns, display color values, and a 
number of 8-bit codes. 

These tables are intended for convenient reference. This appendix is not 
intended as a tutorial for the materials discussed. The brief section 
introductions are for orientation only. 



Bits and Bytes 



This section discusses the relationships between bit values and their 
position within a byte. The following are some rules of thumb regarding the 
65C02 and 6502. 

d A bit is a binary digit; it can be either a or a 1. 
o A bit can be used to represent any two-way choice. Some choices that a 
bit can represent in the Apple He are listed in Table E-l. 

Table E-l. What a Bit Can Represent 



Context 


Representing 


= 


1 = 


Binary number 


Place value 





1 x that power of 2 


Logic 


Condition 


False 


True 


Any switch 


Position 


Off 


On 


Any switch 


Position 


Clear* 


Set 


Serial transfer 


Beginning 


Start 


Carrier (no information yet) 


Serial transfer 


Data 


value 


1 value 


Serial transfer 


Parity 


SPACE 


MARK 


Serial transfer 


End 




Stop bit(s) 


Serial transfer 


Communication 
state 


BREAK 


Carrier 


P reg. bit N 


Neg. result? 


No 


Yes 


P reg. bit V 


Overflow? 


No 


Yes 


Preg.bitB 


BRK command? 


No 


Yes 


P reg. bit D 


Decimal mode? 


No 


Yes 


P reg, bit I 


IRQ interrupts 


Enabled 


Disabled (masked out) 


P reg. bit Z 


Zero result? 


No 


Yes 


P reg. bit C 


Carry required? 


No 


Yes 



* Sometimes ambiguously termed reset. 
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□ Bits can also be combined in groups of any size to represent numbers. 
Most of the commonly used sizes are multiples of four bits. 

□ Four bits comprise a nibble (sometimes spelled nybble). 

n One nibble can represent any of 16 values. Each of these values is 
assigned a number from through 9 and (because our decimal system 
has only ten of the sixteen digits we need) A through F. 

□ Eight bits (two nibbles) make a byte (Figure E-l). 



Figure E-L Bits, Nibbles, and Bytes 



High Nibble 



Low Nibble 



MSB 

7 


6 


5 


4 


3 


2 


1 


LSB 




















$80 


S40 $20 


<\>! 


128 


64 32 


16 


Binary 


Hex 


Dec 


0000 


$00 





0001 


$01 


1 


0010 


$02 


2 


0011 


$03 


3 


0100 


$04 


4 


0101 


$05 


5 


0110 


$06 


6 


0111 


$07 


7 


1000 


$08 


8 


1001 


$09 


9 


1010 


S0A 


10 


1011 


SOB 


11 


1100 


$0C 


12 


1101 


SOD 


13 


1110 


$0E 


14 


1111 


$0F 


15 



m 

4 



B01 Hexadecimal 

1 Decimal 



d One byte can represent any of 16 x 16 or 256 values. The value can be 
specified by exactly two hexadecimal digits. 

□ Bits within a byte are numbered from bit on the right to bit 7 on the left. 

□ The bit number is the same as the power of 2 that it represents, in a 
manner completely analogous to the digits in a decimal number. 
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d One memory position in the Apple He contains one eight-bit byte of data. 
d How byte values are interpreted depends on whether the byte is an 

instruction in a language, part or ail of an address, an ASCII code, or 

some other form of data. 

□ Two bytes make a word. The sixteen bits of a word can represent any 
one of 256 x 256 or 65536 different values. 

□ The 65C02 uses a 16-bit word to represent memory locations. It can 
therefore distinguish among 65536 (64K) locations at any given time. 

□ A memory location is one byte of a 256-byte page. The low-order byte of 
an address specifies this byte. The high-order byte specifies the memory 
page the byte is on. 



Hexadecimal and Decimal 



Use Table E-2 for conversion of hexadecimal and decimal numbers. 



Table E-2. Hexadecimal/Decimal Conversion 



Digit 



$x000 $0x00 $00x0 SOOOx 



F 


61440 


38411 


240 


15 


E 


57344 


3584 


224 


14 


D 


53248 


3328 


208 


13 


C 


49152 


3072 


192 


12 


B 


45056 


2816 


176 


11 


A 


40960 


2560 


160 


10 


9 


36864 


2304 


144 


y 


- 


32768 


2048 


128 


8 


7 


28672 


1792 


112 


7 


6 


24576 


1536 


96 


6 


5 


20480 


1280 


m 


5 


4 


16384 


1024 


64 


4 


3 


12288 


768 


48 


3 


2 


8192 


512 


32 


2 


I 


4096 


256 


16 


1 
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To convert a hexadecimal number to a decimal number, find the decimal 
numbers corresponding to the positions of each hexadecimal digit. Write 
them down and add them up. 



Examples: 

$3C = ? 



$FD47 



$30 
$0C 



48 
12 



*3C 



68 



$F000 


- 


61440 


$ DBG 


- 


3328 


$ 40 


- 


64 


* 7 


= 


? 



$FD47 - 64839 



To convert a decimal number to hexadecimal, subtract from the decimal 
number the largest decimal entry in the table that is less than the number. 
Write down the hexadecimal digit (noting its place value) also. Now 
subtract the largest decimal number in the table that is less than the 
decimal remainder, and write down the next hexadecimal digit. Continue 
until you have zero left. Add up the hexadecimal numbers. 



Example: 

1621S 



I ? 



16215 - 


12288 


» 3927 


12288 


- 17000 


3927 - 


3840 


- 87 


3840 


- * F00 


87 - 


80 


= 7 


80 


- * 50 




7 




7 


= » 7 



16215 



*7F57 
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Hexadecimal and Negative Decimal 

If a number is larger than decimal 32767, Applesoft BASIC allows and 
Integer BASIC requires that you use the negative-decimal equivalent of the 
number. Table E-3 is set up to make it easy for you to convert a 
hexadecimal number directly to a negative decimal number. 



Table E-3. Hexadecimal to Negative Decimal Conversion 



Digit 



SxOOO $$0x00 $$00x0 $$000x 



F 











-] 


E 


4096 


-256 


-16 


-2 


D 


-8192 


-512 


-32 


3 


C 


-12288 


-768 


-48 


-4 


B 


-16384 


-1024 


■64 


-5 


A 


-20480 


-1280 


-80 


-D 


9 


-24576 


-1536 


-96 


-7 


8 


-28672 


-1792 


-112 


-8 


7 




-2048 


-128 


-9 


6 




-2304 


-144 


-10 







-2560 


-160 


-11 


4 




-2816 


-176 


•12 


3 




-3072 


-192 


■13 


2 




-3328 


-208 


-14 


: 




-3584 


-224 


-15 







-3840 


-240 


•16 



To perform this conversion, write down the four decimal numbers 
corresponding to the four hexadecimal digits (zeros included). Then add 
their values. The resulting number is the desired negative decimal number. 

Example: 

*C010 = - ? 



*C000 


-12288 


% 000 


- 3840 


$ 10 


- 224 


* 


16 



$0010 



1G368 



. 
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To convert, a negative-decimal number to a positive decimal number, add it 
to 65536. (This addition ends up looking like subtraction.) 

Example: 



-151 = ♦ ? 
6553G ♦ C-151) 



65536 - 151 



65385 



To convert a negative-decimal number to a hexadecimal number, first 
convert it to a positive decimal number, then use Table E-2, 
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Graphics Bits and Pieces 



Table E-4 is a quick guide to the hexadecimal values corresponding to 7-bit 
high-resolution patterns on the display screen. Since the bits are displayed 
in reverse order, it takes some calculation to determine these values. 
Table E-4 should make it easy. 



Table E-4. Hexadecimal Values for High-Resolution Dot Patterns 



Bits in Data Byte 



6 ; 6 


4 


3 


2 


1 



Dots on Graphics Screen 







12 3 


4 


5 


6 



Bit Pattern 


x=0 


x=l 


Bit Pattern 


x=0 


x=l 


xQOOQOQO 


$00 


$80 


xO 100000 


$02 


$82 


xOOOOOOl 


$40 


SCO 


xOlOOOOl 


$42 


$C2 


xOOOOOlO 


$20 


$A0 


xO 100010 


$22 


$A2 


xOOOOOll 


$60 


$E0 


xO 100011 


$62 


$E2 


xOOGOlOO 


$10 


$90 


xO 100100 


$12 


$92 


xOOOOlOl 


$50 


$D0 


xOIOOIOI 


$52 


$D2 


xOOOOllO 


$30 


$B0 


xOIOOHO 


$32 


$B2 


xOOOOlll 


$70 


$F0 


xO 1001 11 


$72 


$F2 


xOOOlOOO 


$08 


S88 


xOIOIOOO 


$0A 


$8A 


xOOOlOOl 


$48 


$C8 


xO 101001 


$4A 


$CA 


xOOOlOlO 


$28 


$A8 


xOIOIOIO 


$2A 


$AA 


xOOOlOIl 


$68 


$E8 


xOIOIOH 


$6A 


SEA 


xOOOHOO 


$18 


$98 


xOIOHOO 


$1A 


$9A 


xOGOllOl 


$58 


$D8 


xOIOHOI 


$5A 


$DA 


xOOOlllO 


$38 


$B8 


xOIOIHO 


$3A 


$BA 


xOOOllll 


$78 


$F8 


xOlOllll 


$7A 


$FA 


xOOlOOOO 


$04 


$84 


xOl 10000 


$06 


$86 


xOOlOOOI 


$44 


$C4 


xO 110001 


$46 


$C6 


xOOlOOlO 


$24 


$A4 


xO 110010 


$26 


$A6 


xOOlQOll 


$64 


$E4 


xO 110011 


$66 


$E6 


xOOIOIOO 


$14 


$94 


xO 110 100 


$16 


$96 


xOO 10101 


$54 


$D4 


xOl 10101 


$56 


$D6 


xOOlOHO 


$34 


$B4 


xOHOHO 


$36 


$B6 


xOOlOlll 


$74 


$F4 


xOHOlll 


$76 


$F6 


xOOHOOO 


$0C 


$8C 


xOl 11000 


$0E 


$8E 


xOOllOOl 


S4C 


$CC 


xOl 11001 


$4E 


$CE 


xOOllOlO 


$2C 


$AC 


xOlllOlO 


$2E 


$AE 


xOOllOll 


S6C 


$EC 


xOlHOll 


$6E 


SEE 


xOOlllOO 


$1C 


$9C 


xOl 11100 


$1E 


$9E 


xOOlllOl 


$5C 


$DC 


xOllllOl 


$5E 


$DE 


xOOllllO 


$3C 


$BC 


xOlllllO 


$3E 


^BF 


xOOllllI 


$7C 


$FC 


xOllllll 


$7E 


$FE 
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The w represents bit 7, Zeros represent bits that are off; ones bits that are 
on. Use the first hexadecimal value if bit 7 is to be off, and the second if it is 
to be on. 

For example, to get bit pattern 00101110, use $3A; for 10101110, use $BA. 



Table E-4 — Continued. Hexadecimal Values for High-Resolution Dot Patterns 



Bit Pattern 


x=0 


x=l 


Bit Pattern 


x=0 


x=l 


X1000000 


$01 


$81 


xl 100000 


$03 


$83 


xlOOOOQl 


$41 


$C1 


xllOOOOl 


$43 


$C3 


xlOOOOlO 


$21 


$A1 


xllOOOlO 


$23 


$A3 


x 1000011 


S61 


SE1 


xl 100011 


$63 


$E3 


xlOOOlOO 


$11 


$91 


xllOOlOO 


$13 


$93 


xlOOOlOl 


S51 


$D1 


x 1100101 


$53 


$D3 


xlOOOHO 


$31 


$B1 


xl 100110 


$33 


$B3 


xlOOOlll 


$71 


$F1 


x 11001 11 


$73 


$F3 


xlOOlOOO 


$09 


$89 


xl 101000 


$0B 


$8B 


xlOOlOOl 


849 


$C9 


xl 101001 


$4B 


$CB 


xlOOlOlO 


$29 


$A9 


xl 101010 


$2B 


$AB 


xlOOlOU 


S69 


$E9 


xllOlOll 


$6B 


$EB 


xlOOHOO 


S19 


$99 


xl 101100 


SIB 


$9B 


xlOOHOl 


S59 


SD9 


xl 101101 


S5B 


$DB 


xlOOlllO 


$39 


SB9 


xllOlllO 


$3B 


$BB 


xlOOllll 


$79 


SF9 


xllOllll 


$7B 


$FB 


xlOlOOOO 


$05 


: v - 


xl 110000 


$07 


$87 


xlOlOOOl 


$45 


SC5 


xlllOOOl 


$47 


$C7 


xlOlOOlO 


m 


$A5 


xl 110010 


$27 


$A7 


xlOlOOll 


$65 


SE5 


xlllOOll 


$67 


$E7 


xlOlOlOO 


$15 


$95 


xlllOlOO 


$17 


$97 


X1010101 


$55 


$D5 


xlllOlOl 


$57 


$D7 


xlOlOHO 


Soc 


IBS 


xiiiono 


$37 


$B7 


xlOlOlll 


$75 


$F5 


xiiiom 


$77 


$F7 


xlOHOOO 


SOD 


$8D 


xllllOOO 


$0F 


$8F 


xlOHOOl 


$4D 


$CD 


xllllOOl 


$4F 


$CF 


xlOHOlO 


$2D 


SAD 


xllllOlO 


S2F 


$AF 


xlOHOll 


$6D 


$ED 


xllllOll 


S6F 


$EF 


xlOUlOO 


$1D 


$9D 


xlllllOO 


$1F 


$9F 


xlOlllOl 


$5D 


$DD 


xlllllOl 


$5F 


IDF 


xlOllllO 


$3D 


$BD 


xllllllO 


$3F 


$BF 


xlOlllll 


$7D 


$FD 


xlllllll 


$7F 


$FF 
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Eight-Bit Code Conversions 



The MouseText characters are shown in 
Table E-7. 



Tables E-5 through E-12 show the entire ASCII character set twice: once 
with the high bit off, and once with it on. Here is how to interpret these 
tables. 

□ The Binary column has the 8-bit code for each ASCII character. 

□ The first. 128 AS Gil entries represent 7-bit ASCII codes plus a high-order 
bit of (SPACE parity or Pascal)— for example, 010010000 for the 
letter H. 

u The last 128 ASCII entries (from 128 through 255) represent 7-bit ASCII 

codes plus a high-order bit of 1 (MARK parity or BASIC)— for example, 

11001000 for the letter//. 
d A transmitted or received ASCII character will take whichever form is 

appropriate if odd or even parity is selected— for example, 11001000 for 

an odd-parity H, 01001000 for an even-parity H. 

□ The ASCII Char column gives the ASCII character name. 

□ The Interpretation column spells out the meaning of special symbols 
and abbreviations, where necessary. 

□ The What to Type column indicates what keystrokes generate the ASCII 
character (where it is not obvious). 

d The columns marked Pri mdAU indicate what displayed character 
results from each code when using the primary or alternate display 
character set, respectively. Boldface is used for inverse characters; italic 
is used for flashing characters. 

Note that the values $40 through $5F (and SCO through $DF) in the 
alternate character set are displayed as MouseText characters if 
MouseText is turned on. 
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Note: The primary and alternate displayed character sets in Tables E-5 
through E 12 are the result of firmware mapping. The character generator 
ROM actually contains only one character set. The firmware mapping 
procedure is described in the section "Inverse and Flashing Text," in 
Chapter 3. 



Table E-5. Control Characters, High Bit Off 



Binary 


Dec 



i 

2 

3 

4 

5 
6 
7 

8 

9 

10 

11 

12 
13 
14 

15 
16 

17 

IS 
19 

2") 
23 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 


Hex 

$00 
$01 
$02 
$03 
$04 
$05 
$06 
$07 
$08 
$09 
$0A 
$0B 
$0C 
SOD 
$0E 
$0F 
S10 

$11 

$12 
$13 
$14 
$15 
$16 
$17 
$18 
$19 
$1A 
$1B 
$1C 
$1D 
$1E 
$1F 


ASCII 

Char 

NUL 

SOH 

STX 

ETX 

EOT 

ENQ 

ACK 

BEL 

BS 

HT 

LF 

VT 

FF 

CR 

SO 

SI 

DLE 

DCl 

DC2 

DG3 

DC4 

NAK 

SYN 

ETB 

CAN 

EM 

SUB 

ESC 

FS 

GS 

RS 

US 


Interpretation 

Blank (null) 
Start of Header 
Start of Text 
End of Text 
End of Transm. 
Enquiry 
Acknowledge 
BeU 

Backspace 
Horizontal Tab 
Line Feed 
Vertical Tab 
Form Feed 
Carriage Return 
Shift Out 
Shift In 

Data Link Escape 
Device Control 1 
Device Control 2 
Device Control 3 
Device Control 4 
Neg. Acknowledge 
Synchronization 
End of Text Blk, 
Cancel 

End of Medium 
Substitute 
Escape 

File Separator 
Group Separator 
Record Separator 
Unit Separator 


What to Type 


'E3 

[TABj 

m 


Pri 

@ 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

H 

N 

O 

P 

Q 

B 

S 
T 
U 
V 

w 

A 

Y 
Z 

t 
\ 

] 


Alt 


0000000 


I CONTROL H @ 1 


@ 


0000001 


| CONTROL H A | 


A 


0000010 


| CONTROL H B | 


B 


0000011 


| CONTROL |-| C | 


C 


0000100 


| CONTROL H D | 


I) 


0000101 


| CONTROL H E | 


E 


0000110 


| CONTROL H F | 


F 


0000111 


| CONTROL H G 1 


G 


0001000 


1 CONTROL H H | 01 


H 


0001001 


I control H 1 1 or 


I 


0001010 


1 control H J 1 or 


J 


0001011 


| CONTROL H K 1 01 


K 


0001100 


i CONTROL HT] 


L 


0001101 


| CONTROL H M | 


r| return 1 
esc 1 


M 


0001110 


| CONTROL j-( N | 


N 


0001111 


I CONTROL H | 


O 


0010000 


1 CONTROL H P| 


P 


0010001 


I CONTROL H Q | 


Q 


0010010 


| CONTROL hi R 


R 


0010011 


1 CONTROL H S | 


S 


0010100 


1 CONTROL H T | 


T 


0010101 


| CONTROL H U | 01 





0010110 


I CONTROL H V | 


V 


0010111 


I CONTROL H W | 


W 


0011000 
0011001 
0011010 
0011011 
0011100 
0011101 
0011110 
0011111 


| CONTROL H X | 
[ CONTROL HT| 
| CONTROL H~Z] 

t control H [ | or 

[ CONTROL H \1 

[ control H 1 1 
[ control |-[ * 1 

i control i-rn 


X 

Y 
Z 

[ 

\ 

] 
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Table E-6. Special Characters, High Bit Off 



ASCII 



Binary 


Dec 


Hex 


Char 


[nterpretatioi 


0100000 


32 


$20 


SP 


Space 


0100001 


33 


$21 


i 




0100010 


34 


$22 


" 




0100011 


3S 


$23 


# 




0100100 


36 


$24 


$ 




0100101 


37 


$25 


% 




0100110 


38 


$26 


k 




0100111 


39 


$27 


' 


Closing Quote 


0101000 


40 


$28 


C 




0101001 


41 


$29 


) 




0101010 


42 


$2A 


* 




0101011 


43 


$2B 


+ 




0101100 


44 


$2C 


i 


Comma 


0101101 


45 


$2D 




Hyphen 


0101110 


■46 


$2E 




Period 


0101111 


47 


$2F 


/ 




0110000 


48 


$30 







0110001 


49 


$31 


1 




0110010 


50 


$32 


2 




0110011 


51 


$33 


3 




0110100 


52 


$34 


4 




0110101 


53 


$35 


5 




0110110 


54 


$36 


6 




0110111 


7)h 


$37 


7 




0111000 


56 


$38 


8 




0111001 


57 


$39 


9 




0111010 


58 


$3A 






0111011 


59 


$3B 






0111100 


65 


$3C 


< 




0111101 


61 


$3D 


= 




0111110 


62 


$3E 


> 




0111111 


63 


$3F 


9 





What to Type 

I space [bar 



Pri 



Alt 



# 


M 


$ 


% 


% 


% 


& 


& 


) 


t 


( 


( 


) 


) 


* 


+ 


+ 


+ 


J 


t 


/ 


/ 








1 


1 


2 


2 


3 


3 


4 


4 


5 


5 


6 


6 


7 


7 


8 


s 


9 


9 



> 

? 



> 
? 



:>■ 
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Table E-7. 


Uppercase Characters, High Bit Off 












ASCII 








Binary 


Dec 


Hex 


Char 


Interpretation What to Type Pri 


Alt 


1000000 


64 


$40 


(§ 




@ 


tf 


1000001 


65 


$41 


A 




A 


d 


1000010 


66 


$42 


B 




B 


k 


1000011 


67 


$43 


C 




C 


X 


1000100 


68 


$44 


D 




I) 


>/ 


1000101 


69 


$45 


E 




E 


9 


1000110 


70 


$46 


F 




F 


si 


1000111 


71 


$47 







G 


^. 


1001000 


7^ 


$48 


H 




H 


<r 


1001001 


73 


$49 


1 




I 




1001010 


74 


$4A 


J 




J 


i 


1001011 


75 


$4B 


K 




K 


1 


1001100 


76 


$4C 


L 




I 




1001101 


77 


S4D 


M 




M 


«J 


1001110 


78 


S4E 


N 




N 


■ 


1001111 


7'!' 


$4F 










± 


1010000 


80 


S50 


? 




P 


£ 


1010001 


*: 


$51 


3 




o 


4s 


1010010 


82 


$52 


R 




R 


M 


1010011 


83 


$53 


S 




9 




1010100 


84 


$54 


T 




T 


L 


1010101 


85 


$55 


U 




a 


^ 


1010110 


■So 


$56 


V 




V 


H 


1010111 


87 


$57 


w 




W 


■ 


1011000 


88 


$58 


X 




X 


C 


1011001 


89 


$59 


Y 




Y 


3 


1011010 


90 


$5A 


I 




z 


I 


1011011 


91 


S5B 


I 


Opening Bracket 


I 


♦ 


1011100 


92 


$5C 


\ 


Reverse Slant 


I 


^~ 


1011101 


93 


$5D 


1 


Closing Bracket 


/ 


JL 


1011110 


94 


$5E 


A 


Caret 




3 


1011111 


95 


$5F 


_ 


Underline 




1 
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Table E-8. Lowercase Characters, High Bit Off 









ASCII 






Binary ] 


Dec 


Hex 


Char 


Interpretation 


What to Type 


1100000 ! 


if; 


$60 


* 


Opening Quote 




1100001 ! 


17 


$61 


a 






1100010 ! 


18 


$62 


b 






1100011 ! 


)9 


$63 


c 






1100100 


LOO 


$64 


d 






1100101 


101 


$65 


e 






1100110 


[02 


$66 


f 






1100111 


[03 


$67 


g 






1101000 


04 


$68 


h 






noiooi : 


05 


$69 


i 






noioio : 


.06 


$6A 


J 






noioii i 


07 


$6B 


k 






lionoo : 


08 


$6C 


1 






1101101 ] 


09 


$6D 


m 






1101110 ] 


[10 


$6E 


n 






1101111 ] 


11 


$6F 









1110000 ] 


12 


$70 


P 






1110001 ] 


13 


$71 


q 






1110010 ] 


14 


$72 


r 






1110011 ] 


15 


$73 


s 






1110100 ] 


16 


$74 


t 






1110101 3 


17 


$75 


u 






1110110 J 


18 


$76 


V 






1110111 ] 


19 


$77 


« 






1111000 1 


20 


$78 


X 






1111001 ] 


21 


$79 


y 






1111010 I 


22 


$7A 


z 






1111011 1 


23 


$7B 


{ 


Opening Brace 




1111100 i 


21 


$7C 


1 


Vertical Line 




1111101 ] 


25 


$7D 


{ 


Closing Brace 




1111110 ] 


26 


$7E 




Overline (Tilde) 




1111111 


27 


$7F 


DEL 


Delete/ Rubout 





Pri 



# 
$ 




1 
2 
3 
4 
5 
6 
? 



> 

? 



Alt 



a 
b 
c 

d 

e 

f 

g 
h 

i 

J 
k 

1 



y 

z 



DEL 



m 
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Table E-9. Control Characters, High Bit On 



Binary 


Dec 

128 
129 
130 
131 
.32 
133 
134 
135 
.36 
1 37 
138 
139 
.40 
141 
142 
143 
144 
145 
48 
147 
148 
49 
50 
151 
52 
53 
54 
155 
56 
57 

59 


Hex 

$80 
$81 
$82 
$83 
$84 
$85 
$86 
$87 
$88 
$89 
$8A 
$8B 
S8C 
$8D 
$8E 
$8F 
$90 
$91 
$92 
$93 
$94 
$95 
$96 
$97 
S98 
$99 
$9A 
$9B 
$9C 
$9D 
$9E 
$9F 


ASCII 
Char 

NUL 

SOH 

STX 

ETX 

EOT 

ENQ 

ACK 

BEL 

BS 

HT 

LF 

VT 

FF 

CR 

SO 

SI 

DLE 

DCl 

DC2 

DC3 

DC4 

NAK 

SYN 

ETB 

CAN 

EM 

SUB 

ESC 

FS 

GS 

RS 

US 


Interpretation 

Blank (null) 
Start of Header 
Start of Text 
End of Text 
End of Transm. 
Enquiry 
Acknowledge 
Bell 

Backspace 
Horizontal Tab 
Line Feed 
Vertical Tab 
Form Feed 
Carriage Return 
Shift Out 
Shift In 

Data Link Escape 
Device Control 1 
Device Control 2 
Device Control 3 
Device Control 4 
Neg. Acknowledge 
Synchronization 
End of Text Blk. 
Cancel 

End of Medium 
Substitute 
Escape 

File Separator 
Group Separator 
Record Separator 
Unit Separator 


What to Type 


r0 

[tab] 

E 


Pri 

eg 

A 
B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

X 



p 

Q 

R 
S 
T 
I" 
V 

w 

X 
Y 

Z 

i 
\ 

] 


Alt 


10000000 


CONTROL H @ 1 


@ 


10000001 


CONTROL H A J 


A 


10000010 


CONTROL h| B J 


B 


10000011 


CONTROL H C | 


C 


10000100 


CONTROL ]-[ D | 


D 


10000101 


CONTROL H E | 


E 


10000110 


CONTROL H F | 


F 


10000111 


CONTROL H G 1 


G 


10001000 


CONTROL H H |0 


H 


10001001 


control H 1 1 or 


[ 


10001010 


CONTROL H J 1 OI 


J 


10001011 


CONTROL H K | O] 


K 


10001100 


CONTROL H L 


L 


10001101 


CONTROL H M | O 


r| RETURN] 

fescl 


M 


10001110 


CONTROL H N | 


N 


10001111 


CONTROL H | 





10010000 


CONTROL H P 1 


P 


10010001 


CONTROL H | 


Q 


10010010 


CONTROL H R 1 


R 


10010011 . 


CONTROL H S [ 


S 


10010100 


CONTROL H T | 


T 


10010101 


CONTROL hi U | O] 


;; 


10010110 


CONTROL H V i 


V 


10010111 


CONTROL H W ] 


w 


10011000 . 


CONTROL H X i 


X 


10011001 


CONTROL H Y | 


Y 


loonoio ; 


CONTROL H Z 


Z 


looiion : 


control H [ 1 or 


i 


looinoo : 


CONTROL H 1 


\ 


10011101 


CONTROL H 1 1 


] 


looiino ; 


CONTROL H A 1 


* 


looiiin : 


CONTROL H - 1 


_ 



[Sight-Bit Code Copverslons 
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Table E-10. Special Characters, High Bit On 









ASCII 






Binary 


Dec 


Hex 


Char 


Interpretation 


What to Type 


10100000 


160 


$A0 


SP 


Space 


SPACE bar 


10100001 


161 


$A1 








10100010 


162 


$A2 


Tl 






10100011 


163 


$A3 


# 






10100100 


164 


$A4 


$ 






10100101 


165 


SA5 


% 






10100110 


166 


SA6 


& 






10100111 


167 


$A7 




Closed Quote 

(acute accent) 




10101000 


168 


$A8 


( 






10101001 


1 69 


$A9 


J 






10101010 


17!) 


$AA 


* 






10101011 


171 


SAB 


- 






10101100 


.72 


SAC 


J 


Comma 




10101101 


.771 


SAD 




Hyphen 




10101110 


u 


$AE 




Period 




10101111 


75 


$AF 


/ 






10110000 


76 


$B0 









loiioooi : 


77 


SB1 


1 






lonooio ; 


78 


$B2 


2 






10110011 


7U 


$B3 


3 






10110100 1 


80 


$B4 


4 






10110101 ] 


81 


$B5 


5 






10110110 ] 


82 


SB6 


6 






10110111 ] 


S3 


$B7 


7 






10111000 ] 


84 


$B8 


8 






10111001 1 


bb 


SB9 


9 






10111010 1 


86 


SBA 








10111011 1 


87 


$BB 


j 






10111100 1 


Ss 


SBC 


< 






10111101 1 


89 


SBD 


= 






10111110 1 


90 


SBE 


> 






10111111 1 


91 


$BF 


9 







Pri 



Alt 



c 
) 


i 

* 


- 


+ 

■ 








: 


i 


2 


2 


3 


3 


4 


4 


5 


5 


6 


6 


7 


7 


- 


8 


9 


9 



> 



> 



m) 
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Table E-ll. Uppercase Characters, High Bit. On 



Binary 

1 
i 
1 
1 

1 



OOOO01 
000010 
000011 
000100 
000101 
000110 
000111 
001000 
001001 
001010 
001011 
001100 
001101 
001110 
001111 
010000 
010001 
11010010 
1010011 
010100 
010101 
010110 
010111 
011000 
011001 
011010 
011011 
011100 
011101 
011110 
011111 



Dec 



94 



!^7 



200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 



Hex 

$C0 

$C1 

$C2 

$C3 

$C4 

$C5 

$C6 

$C7 

$C8 

$C9 

$CA 

$CB 

ICC 

SCD 

SCE 

SCF 

$D0 

$D1 

$D2 

$D3 

$D4 

SD5 

$D6 

SD7 

$D8 

$D9 

$DA 

$DB 

$DC 

$DD 

SDE 

$DF 



ASCII 
Char 

(fl 

A 
B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 



P 

Q 

R 

S 

T 

U 

V 

w 

X 
Y 

7 



Interpretation 



What to Type 



Pri 



Alt 



Opening Bracket 
Reverse Slant 
Closing Bracket 
Caret 
Underline 



@ 


5. 


A 


A 


B 


B 


C 


C 


D 


D 


E 


E 


F 


F 


G 


G 


H 


H 


I 


I 


■J 


J 


K 


K 


L 


L 


M 


M 


N 


X 








P 


p 


Q 


Q 


R 


R 


S 


S 


T 


T 


U 


U 


V 


V 


w 


w 


X 


X 


Y 


¥ 


z 


z 
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Table E-12, Lowercase Characters, High Bit On 









ASCII 










Binary 


Dec 


Hex 


Char 


Interpretation 


What to Type 


Pri 


Alt 


11100000 


224 


$E0 


* 


Open Quote 




* 


- 


11100001 


225 


$E1 


a 






a 


a 


11100010 


226 


$E2 


b 






b 


b 


11100011 


227 


$E3 


c 






c 


c 


11100100 


228 


$E4 


d 






d 


d 


11100101 


229 


SE5 


e 






e 


e 


11100110 


230 


$E6 


f 






f 


f 


11100111 


231 


$E7 


g 






g 


g 


11101000 


232 


$E8 


h 






h 


h 


11101001 


233 


$E9 


i 






i 


i 


11101010 


234 


$EA 


J 






j 


j 


11101011 


235 


$EB 


k 






k 


k 


11101100 


236 


$EC 


1 






1 


1 


11101101 


237 


SED 


it; 






m 


rr 


11 101 110 


238 


SEE 


li 






n 


r. 


11101111 


239 


$EF 















11110000 


240 


$F0 


p 






P 


F 


11110001 


241 


$F1 


q 






q 


q 


11110010 


242 


$F2 


r 






r 


r 


11110011 


243 


$F3 


s 






s 


s 


11110100 


244 


$F4 


t 






t 


t 


11110101 


245 


$F5 


u 






u 


u 


11110110 


246 


$F6 


V 






V 


V 


11110111 


247 


$F7 


w 






w 


w 


11111000 


248 


$F8 


X 






X 


X 


11111001 


249 


$F9 


y 






y 


y 


11111010 


250 


$FA 


z 






z 


z 


11111011 


251 


$FB 


{ 


Opening Brace 




1 


! 


11111100 


252 


$FC 


1 


Vertical Line 




1 


1 


11111101 


253 


$FD 


I 

1 


Closing Brace 




I 




11111110 


254 


$FE 




Overline (Tilde) 








11111111 


255 


$FF 


DEL 


Delete (Rubout) 


DELETE 


DEL 


DEL 



252 
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This appendix contains copies of the tables you will need to refer to 
frequently, for example, ASCII codes and soft-switch location. The figures 
all have their original figure numbers. 



Table 2-3. Keys and ASCII Codes 



Note: Codes are sh 


own here 


in ke'ct 


idecimal; to find the decimal 


equivalents, refer 


to Table £ 


'•* 


















Normal 


Control 


Shift 


Both 


Key 


Code 


Char 


Code 


Char 


Code 


Char 


Code 


Char 


I DELETE | 


7F 


DEL 


7F 


DEL 


7F 


DEL 


7F 


DEL 


s 


08 


BS 


08 


BS 


08 


BS 


08 


BS 


[tab] 


09 


HT 


09 


HT 


09 


HT 


09 


HT 


m 


0A 


LF 


0A 


LF 


0A 


LF 


0A 


LF 


B 


OB 


VT 


OB 


VT 


0B 


VT 


0B 


VT 


[return 1 


0D 


CR 


0D 


CR 


0D 


CR 


0D 


CR 


H 


15 


NAK 


15 


NAK 


15 


NAK 


10 


NAK 


| ESC | 


IB 


ESC 


LB 


ESC 


IB 


ESC 


IB 


ESC 


| SPACE 1 


20 


SP 


20 


SP 


20 


SP 


20 


SP 


' " 


27 


i 


27 


■ 


22 


" 


22 


" 


, < 


2C 


! 


2C 


i 


3C 


< 


3C 


< 


-_ 


21) 


- 


IF 


US 


5F 


_ 


IF 


US 


. > 


2E 




IV, 




3E 


> 


3E 


> 


/? 


2F 




2F 




3F 





■^ 


? 


0) 


30 





30 





29 


) 


29 


) 


1! 


31 


: 


31 


1 


21 


1 


21 


! 


2@ 


>2 


2 


00 


NUL 


- 


@ 


00 


NUL 


3# 


33 


3 


33 


3 


23 


§ 


23 


# 


4$ 


34 


4 


34 


i 


•4 


% 


24 


$ 


5% 


:- ! J ; 


5 


35 


5 


25 


% 


25 


% 


6 " 


36 


6 


IE 


RS 


5E 




:e 


RS 


7& 


37 


7 


37 


7 


26 


& 


26 


& 


8* 


38 


S 


38 


3 


2A 


* 


2A 


« 


9( 


39 
3B 


9 


39 
3B 


9 


2^ 
3A 


( 


28 
3A 


( 


= + 


3D 


= 


3D 


= 


2B 


+ 


2B 


+ 


[{ 


5B 


[ 


LB 


ESC 


7B 


; 
i 


IB 


ESC 


\l 


5C 


\ 


1C 


FS 


7C 




1C 


FS 


I}. 


5D 


] 


LD 


GS 


7D 


\ 


ID 


GS 




60 




60 




7E 


^ 


7E 





- 
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Table 2-3— Continued. Keys and ASCII Codes 



Note: Codes are si 


wwn here 


m hex 


idecimal; 


to find th 


e decimal 


equivalents, refer 


to Table E-S. 


















Normal 


Control 


Shift 




Both 


Key 


Code 


Char 


Code 


Char 


Code 


Char 


Code 


Char 


A 


61 


a 


01 


SOH 


41 


A 


03 


SOH 


B 


62 


h 


02 


STX 


42 


B 


02 


STX 


C 


63 


c 


03 


ETX 


43 


C 


03 


ETX 


D 


64 


d 


M 


EOT 


44 


1) 


04 


EOT 


E 


65 


e 


05 


ENQ 


45 


E 


05 


ENQ 


P 


66 


E 


06 


ACK 


46 


P 


06 


ACK 


G 


67 


g 


07 


BEL 


47 


G 


07 


BEL 


H 


68 


:. 


08 


BS 


4H 


l-l 


us 


BS 


I 


69 


i 


09 


;:t 


■t9 


I 


09 


HT 


J 


6A 


J 


OA 


if 


4A 


J 


0A 


LF 


K 


6B 


1 


OB 


VT 


4B 


K 


OB 


VT 


L 


6C 


: 


3C 


FF 


4C 


I. 


0C 


FF 


M 


•:: 


m 


OD 


CR 


4D 


M 


0D 


CR 


X 


6E 


: 


0E 


SO 


4E 


N 


0E 


SO 





OF 





OF 


<: 


4F 





OF 


SI 


F 


70 


P 


10 


DLE 


50 


P 


10 


DLE 


Q 


"1 


q 


;: 


DC1 


'■: 


J 


1] 


DC1 


F 


"1 


r 


12 


DC2 


52 


F: 


12 


DC2 


S 


7:1 


< 


13 


DC3 


53 


S 


13 


DCS 


T 


74 


t 


14 


DC4 


54 


T 


14 


DC4 


U 


~ r - 


u 


IS 


NAK 


55 


l 


15 


NAK 


V 


76 


V 


16 


SYN 


56 


V 


16 


SYN 


w 


77 


w 


17 


ETB 


57 


w 


17 


ETB 


A 


78 


X 


18 


CAN 


58 


X 


18 


CAN 


Y 


79 


y 


19 


EM 


59 


Y 


ig 


EM 


Z 


7A 


z 


1A 


SUB 


5A 


z 


1A 


SUB 



Table 2-2. Keyboard Memory Locations 



Location 
Hex Decimal 

$C000 49152 -16384 

$C010 49168 -16368 



Description 

Keyboard data and strobe 

Any-key-down flag and clear-strobe switch 
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Table 24. Video Display Specifications 



Display modes: 



Text capacity: 
Character set: 
Display formats: 
Low-resolution graphics: 

High-resolution graphics: 



Double-high-resolution 
graphics: 



40-column text; map: Figure 2-2 
80-column text; map: Figure 2-3 

Low-resolution color graphics; map: Figure 2-7 

High-resolution color graphics; map: Figure 2-8 

Double-high-resolution color graphics; 
map: Figure 2-9 

24 lines by 80 columns (character positions) 

96 ASCII characters (uppercase and lowercase) 

Normal, inverse, flashing, MouseText (Table 2-5) 

16 colors (Table 2-6) 40 horizontal by 48 vertical; 
map: Figure 2-7 

6 colors (Table 2-7) 140 horizontal by 192 vertical 
(restricted) 

Black-and-white: 280 horizontal by 192 vertical; 
map: Figure 2-8 

16 colors (Table 2-8) 140 horizontal by 192 vertical 
(no restrictions) 

Black-and-white: 560 horizontal by 192 vertical: 
map: Figure 2-9 
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Table 2-8. Double-High-Resolution Graphics Colors 













Repeated 


Color 


abO 


mbl 


ab2 


mb3 


Bit Pattern 


Black 


$00 


$00 


$00 


$00 


0000 


Magenta 


$08 


$11 


$22 


$44 


0001 


Brown 


$44 


$08 


$11 


S22 


0010 


Orange 


$4C 


$19 


$33 


$66 


0011 


Dark Green 


$22 


$44 


$08 


$11 


0100 


Gray 1 


$2A 


$55 


$2A 


$55 


0101 


Green 


$66 


$4C 


$19 


$33 


0110 


Yellow 


$6E 


$5D 


$3B 


$77 


0111 


Dark Blue 


$11 


$22 


$44 


$08 


1000 


Purple 


$19 


$33 


$66 


$4C 


1001 


Gray 2 


$55 


$2A 


$55 


$2A 


1010 


Pink 


$5D 


$3B 


$77 


$6E 


1011 


Medium Blue 


$33 


$66 


$4C 


$19 


1100 


Light Blue 


$3B 


$77 


$6E 


$5D 


1101 


Aqua 


$77 


$6E 


$5D 


$3B 


1110 


White 


$7F 


$7F 


$7F 


$7F 


mi 



Table 2-9, Video Display Page Locations 



Display Mode 


Display 
Page 


Lowest Address 
Hex Dec 


Highest Address 
Hex Dec 


40-column text, 

low-resolution 

graphics 


1 

2* 


$0400 
$0800 


1024 
2048 


$07FF 
$0BFF 


2047 
3071 


80-column text 


1 

2' 


$0400 

$0800 


1024 
2048 


$07FF 
$0BFF 


2047 
3071 


High-resolution 
graphics 


1 
2 


$2000 
$4000 


8192 
16384 


$3FFF 

$5FFF 


16383 
24575 


Double-high- 
resloution graphics 


It 
2t 


$2000 
$4000 


8192 
16384 


$3FFF 

$5FFF 


16383 
24575 



* This is not supported by firmware; for instructions on how to switch pages, refer to the 
section "Display Mode Switching" in Chapter 2. 

t See the section "Double-High-Resolution Graphics," in Chapter 2. 
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Table 2-10. Display Soft Switches 



Note: W means write anything to the location, R means read the location, R/W 
means read or write, and R? 'means read the location and then check bit 7. 

Name Action Hex Function 

ALTCHAR W $C00E Off: display text using primary character set 
ALTCHAR W $C0OF On: display text using alternate character set 
RDALTCHAR R7 $C01E Read ALTCHAR switch (1 = on) 


80COL 
80COL 
RD80COL 


W 

w 

R7 


scooc 

$C00D 
SC01F 


Off: display 40 columns 
On: display 80 columns 
Read 80COL switch (1 = on) 


80STORE 
80STORE 
RD80STORE 


W 

w 

R7 


scooo 

SC001 
SC018 


Off: cause PAGE2 on to select auxiliary RAM 
On: allow PAGE2 to switch main RAM areas 
Read 80STORE switch (1 - on) 


PAGE2 
PAGE2 

RDPAGE2 


R/W 
R/W 

R7 


$C054 
SC055 

SC01C 


Off: select Page 1 

On: select Page 2 or, if 80STORE on, Page 1 in 

auxiliary memory 

Read PAGE2 switch (1 = on) 


TEXT 
TEXT 
RDTEXT 


R/W 
R/W 
R7 


■SC050 
SC051 
SC01A 


Off: display graphics or. if MLXED on, mixed 

On: display text 

Read TEXT switch (1 - on) 


MIXED 
MIXED 
RDM1XED 


R/W 
R/W 
R7 


SC052 
IC053 
SC01B 


Off: display only text or only graphics 
On: if TEXT off, display text and graphics 
Read MLXED switch (1 = on) 


HIRES 
HIRES 

RDH1RES 


R/W 
R/W 

R7 


SC056 
SC059 

SC01D 


Off: if TEXT off, display low-resolution graphics 
On: if TEXT off, display high-resolution or, if 
DHIRES on, double-high- resolution graphics 
Read HIRES switch (1 = on) 



IOUDIS W SC07E On: disable IOU access for addresses $C058 to 

$C05F; enable access to DHIRES switch * 

IOUDIS W $C07F Off: enable IOU access for addresses $C058 to 

$C05F; disable access to DHIRES switch * 

RDIOUDIS R7 $C07E Read IOUDIS switch (1 = off) t 



DHIRES R/W 

DHIRES R/W 

RDDHIRES R7 



$C05E On: (if IOUDIS on) turn on double-high-res. 
$C05F Off: (if IOUDIS on) turn off double-high -res. 
$C07F Read DHIRES switch (1 = on) t 



* The firmware normally leaves IOUDIS on. See also t. 

t Reading or writing any address in the range SC070-SC07F also triggers the paddle timer 
and resets VBLINT (Chapter 7). 
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Table 3-1. Monitor Firmware Routines 



Location 


Name 


SC305 


BASICIN 


$C307 


BASICOUT 


$FC9C 


CLREOL 


$FC9E 


CLEOLZ 


$FC42 


CLREOP 


$F832 


CLRSCR 


$F836 


CLRTOP 


$FDED 


COUT 


$FDF0 


COUT1 


$FD8E 


CROUT 


$FD8B 


CROUT1 



$FD6A GETLN 



$F819 
SFC58 



HLINE 
HOME 



SFD1B KEYIN 



SF800 


PLOT 


$F94A 


PRBL2 


$FDDA 


PRBYTE 


$FF2D 


PRERR 


$FDE3 


PRHEX 


$F941 


PRNTAX 


SFDOC 


RDKEY 


$F871 


SCRN 


SF864 


SETCOL 


SFC24 


VTABZ 


$F828 


VLINE 



Description 

With 80-column dirmware active, displays solid, blinking 
cursor. Accepts character from keyboard. 

Displays a character on the screen; used when the 
80-column firmware is active (Chapter 3). 

Clears to end of line from current cursor position. 

Clears to end of line using contents of Y register as cursor 
position. 

Clears to bottom of window. 

Clears the low-resolution screen. 

Clears top 40 lines of low-resolution screen. 

Calls output routine whose address is stored in CSW 
(normally COUT1, Chapter 3), 

Displays a character on the screen (Chapter 3). 

Generates a carriage return character. 

Clears to end of line, then generates a carriage return 
character. 

Displays the prompt character; accepts a string of 
characters by means of RDKEY. 

Draws a horizontal line of blocks. 

Clears window; puts cursor in upper-left corner of 
window. 

With 80-column firmware inactive, displays 
checkerboard cursor. Accepts character from keyboard. 

Plots a single low-resolution block on the screen. 

Sends 1 to 256 blank spaces to the output device. 

Prints a hexadecimal byte. 

Sends err and Control-G to the output device. 

Prints 4 bits as a hexadecimal number. 

Prints contents of A and X in hexadecimal. 

Displays blinking cursor; goes to standard input routine, 
normally KEYIN or BASICIN. 

Reads color value of a low-resolution block. 

Sets the color for plotting in low-resolution. 

Sets cursor vertical position. 

Draws a vertical line of low-resolution blocks. 
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Table S-3a. Control Characters With 80-Column Firmware Off 



Control 


ASCII 


Apple He 


Character 


Name 


Name 


Control-G 


BEL 


bell 


Control-H 


BS 


backspace 


Control-J 


LF 


line feed 


Control-M 


CR 


return 



Action Taken by CO0T1 

Produces a 1000 Hz tone for 0.1 second. 

Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 

Moves cursor position down to next line in 
window; scrolls if needed. 

Moves cursor position to left end of next 
line in window; scrolls if needed. 



Table 33b, C 


ontrol Ch 


aracters With 


80-Column Firmware On 


Control 
Character 


ASCII 

Name 


Apple lie 
Name 


Action Taken by BASICOUT 


Control-G 


BEL 


bell 


Produces a 1000 Hz tone for 0.1 second. 


Control-H 


BS 


backspace 


Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 


Control-J 


LF 


line feed 


Moves cursor position down to next line in 
window; scrolls if needed. 


Control-Kt 


VT 


clear EOS 


Clears from cursor position to the end of 
the screen. 


Contro]-L t 


FF 


home 
and clear 


Moves cursor position to upper-left corner 
of window and clears window. 


Control-M 


CR 


return 


Moves cursor position to left end of next 
line in window; scrolls if needed. 


Control-N t 


SO 


normal 


Sets display format normal. 


Control-0 1 


SI 


inverse 


Sets display format inverse. 


Control-Q t 


DC1 


40-column 


Sets display to 40-column. 


Control-Rt 


DC2 


80-column 


Sets display to 80-column. 


Control-S * 


DC3 


stop-list 


Stops listing characters on the display 



until another key is pressed. 



m 
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Table 3-3b— Continued, Control Characters With 80-Column Firmware On 



Action Taken by BASICOUT 

Deactivates 80-column video firmware, 

Scrolls the display down one line, leaving 
the cursor in the current position. 

Scrolls the display up one line, leaving the 
cursor in the current position. 

Disable MouseText character display; use 
inverse uppercase. 

Moves cursor position to upper-left corner 
of window (but doesn't clear). 

Clears the line the cursor position is on. 

Map inverse uppercase characters to 



Moves cursor position one space to the 
right; from right edge of window, moves it 
to left end of line below. 

Clears from the current cursor position to 
the end of the line (that is, to the right 
edge of the window). 

Moves cursor up a line, no scroll 



Control 


ASCII 


Apple He 


Character 


Name 


Name 


Control-U t 


NAK 


quit 


Control-Vt 


SYN 


scroll 


Control-W t 


ETB 


scroll-up 


Control-X 


CAN 


disable 
MouseTe: 


Control-Y t 


EM 


home 


Control-Z f 


SUB 


clear line 


Control-[ 


ESC 


enable 
MouseTe: 


Control- \t 


FS 


forward 

space 



Contn)l-)t 



Control-_ 



GS clear EOL 



L'S 



up 



* Only works from the keyboard. 
t Doesn't work from the keyboard. 

Table 3-5. Text Format Control Values 



Note: These mask values apply only to the primary character set (see text). 



Mask Value 

Dec Hex Display Format 

255 $FF Normal, uppercase, and lowercase 

127 $7F Flashing, uppercase, and symbols 

63 $3F Inverse, uppercase, and lowercase 
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Table 3-6. Escape Codes 



Escape Code 



[llcJH or |T] 
flsc] [¥] or [JJ 
resol fc] oriel 

rEsci ^orfn 
rEscimorin 

[|sc][l]or[f] 
rESClPlorrnor riscl fTI 
rEsci mormor nsci nq 
[esc] [k] or UJ or [fsc] Q 
I esc I \W\ or [m] or | esc | [7J 
[MJE3 



[He]® 

ESC 1 1 CONTROL ) fD] 

ESC 1 1 CONTROL | -(T] 
Ts^rc3NTROL> rQl 



Function 

Clears window and homes cursor (places it in upper-left corner of screen), then exits from 
escape mode. 

Moves cursor right one line; exits from escape mode. 

Moves cursor left one line; exits from escape mode. 

Moves cursor down one line; exits from escape mode. 

Moves cursor up one line; exits from escape mode. 

Clears to end of line; exits from escape mode. 

Clears to bottom of window; exits from escape mode. 

Moves the cursor up one line; remains in escape mode. See text. 

Moves the cursor left one space; remains in escape mode. See text. 

Moves the cursor right one space; remains in escape mode. See text. 

Moves the cursor down one line; remains in escape mode. See text. 

If 80-column firmware is active, switches to 40-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 

If 80-column firmware is active, switches to 80-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 

Disables control characters; only carriage return, line feed, BELL, and backspace have an 
effect when printed. 

Reactivates control characters. 

If 80-column firmware is active, deactivates 80-colunm firmware; sets links to KEYIN and 
COUT1; restores normal window size; exits from escape mode. 
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Table 3- 1C 


. Pas 


Control 


Hex 


Eore 


$05 


Forf 


$06 


Gorg 


$07 


Horh 


$08 


Jorj 


$0A 


Kork 


$0B 


Lorl 


$0C 


Morm 


SOD 


X !">!• n 


$0E 



Pascal Video Control Functions 



Function performed 

Turns cursor on (enables cursor display). 

Turns cursor off (disables cursor display). 

Sounds bell (beeps). 

Moves cursor left one column. If cursor was at 
beginning of line, moves it to end of previous line. 

Moves cursor down one row; scrolls if needed. 

Clears to end of screen. 

Clears screen; moves cursor to upper-left of screen. 

Moves cursor to column 0. 

Displays subsequent characters in normal video. 
(Characters already on display are unaffected.) 

Displays subsequent characters in inverse video. 
(Characters already on display are unaffected.) 

Scrolls screen up one line; clears bottom line. 

Scrolls screen down one line; clears top line. 

Moves cursor to upper- left (home) position on screen. 

Clears entire line that cursor is on. 

Moves cursor right one column; if at end of line, does 
Control-M. 

Clears to end of the line the cursor is on, including 
current cursor position; does not move cursor. 

GOTOxy: initiates a GOTOxy sequence; interprets the 
next two characters as x+32 and y+32, respectively. 

If not at top of screen, moves cursor up one line. 



Ooro 



$0F 



Vorv 


$16 


Worw 


$17 


Yory 


$19 


Zorz 


S1A 


lor \ 


$1C 


}or] 


SID 


* or6 


$1E 




$1F 
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Table 4-6. Bank Select Switches 



Note: R means read the location, W means write anything to the location, R/W 
means read or write, and R7 means read the location and then check bit 7, 

Name Action Hex Function 

R $0080 Read RAM; no write; use $D000 bank 2. 

RR $C08 1 Read ROM; write RAM; use $D000 bank 2. 

R SC082 Read ROM; no write; use $DOO0 bank 2. 

RR SC083 Read and write RAM; use $D000 bank 2. 

R $0088 Read RAM; no write; use $DO00 bank 1. 

RR $C089 Read ROM; write RAM; use $D000 bank 1. 

R $C08A Read ROM; no write; use $D000 bank 1, 

RR $C08B Read and write RAM; use SD000 bank 1 . 

RDBNK2 R7 $0011 Read whether SD0O0 bank 2(1) or bank 1(0) 

RDLCRAM R7 $0012 Reading RAM (1) or ROM (0). 

ALTZP W $C008 Off: use main bank, page and page 1. 

ALTZP W $0009 On: use auxiliary bank, page and page 1. 

RDALTZP R7 $0016 Read whether auxiliary (1) or main (0) bank 



IU 
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Table 4-7. Auxiliary-Memory Select Switches 



Name Function 

RAMRD Read auxiliary memory 
Read main memory 
Read RAMRD switch 

RAMWRT Write auxiliary memory 
Write main memory 
Read RAMWRT switch 

80STORE On: access display page 

Off: use RAMRD, RAMWRT 
Read 80STORE switch 

PAGE2 Page 2 on (aux. memory) 
Page 2 off (main memory) 
Read PAGE2 switch 

HIRES On: access high-res. pages 
Off: use RAMRD. RAMWRT 
Read HIRES switch 

ALTZP Auxiliary stack & z.p. 
Main stack & zero page 
Read ALTZP switch 

* When 80STORE is on, the PAGE2 switch selects main or auxiliary display memory, 

t When 80STORE is or. the HIRE^ switch enables you to use the PAGE2 switch to switch 
between the high-resolution Page-1 area in main memory or auxiliary memory. 



Hex 


Location 

Decimal 


Notes 


$C003 
$CG02 
$C013 


49155 -1 
49154 -] 
49171 -] 


6381 
6382 
6365 


Write 
Write 
Read 


$C005 
$C004 
$0014 


49157 -1 
49156 -] 
49172 -] 


.6379 
.6380 
.6354 


Write 
Write 
Read 


$C001 

$cooo 

$C018 


49153 -] 
49152 -: 
49176 -. 


L63S3 

L6384 
[6360 


Write 
Write 
Read 


$C055 
SC054 
$C01C 


49237 -. 
49236 - 
49180 - 


L6299 
L6300 

[6356 


* 
* 

Read 


SC057 
SC056 
SC01D 


49239 • 
49238 - 
49181 - 


16297 

[6298 
L6355 


t 

t 
Read 


SC009 
SC008 
IC016 


49161 - 
49160 - 
49174 - 


16373 
16374 
16352 


Write 
Write 

Read 



Table 4-8. 48K RAM Transfer Routines 



Name Action Hex 

AUXMOVE JSR 



XFER 



Function 



SC312 Moves data blocks between main and auxiliary 
48K memory. 

JMP IG314 Transfers program control between main and 
auxiliary 48K memory. 
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Table 6-5. I/O Memory Switches 



Name 


Function 


1 
Hex 


Location 

Decimal 


Notes 


SLOTC3ROM 


Slot ROM at $C300 
Internal ROM at $C300 
Read SLOTC3ROM switch 


$C00B 
SCOOA 

IC017 


49163 
49162 
49175 


-16373 
-16374 
-16361 


Write 
Write 
Read 


SLOTCXROM 


Slot ROM at $CxOO 
Interna] ROM at $CxOO 
Read SLOTCXROM switch 


SC006 
$C007 
$C015 


49159 
49158 
49173 


-16377 
-16378 
-16363 


Write 
Write 
Read 



Table 6-7. I/O Routine Offsets and Registers Under Pascal 1.1 Protocol 



Addr. 


Offset for 


X Register 


Y Register 


A Register 


$CsOD 


Initialization 
On entry 
On exit 


$Cs 
Error code 


$s0 
(unchanged) 


(unchanged) 


SCsOE 


Read 
On entry 
On exit 


$Cs 
Error code 


$s0 
(unchanged) 


Character read 


SCsOF 


Write 
On entry 
On exit 


$Cs 
Error code 


$s0 
(unchanged) 


Char, to write 
(unchanged) 


$CslO 


Status 

On entry 
On exit 


$Cs 
Error code 


SsO 
(changed) 


Request (0 or 1) 
(unchanged) 
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This appendix explains how to use 80-column text cards with high-level 
languages. Information about using 80-column text cards with assembly 
language programs through the Apple He Monitor firmware is found in 
Chapter 3 of this manual, The information in this appendix applies to the 
Apple He 80-Column Text Card and the Apple He Extended 80-Column Text 
Card. 

If you are using Applesoft, ProDOS, or DOS you can choose to leave the 
80-column text card inactive after installing it. You will want to do this 
when running software that does not take advantage of the 80-column 
display capability. 

The startup procedure for displaying 80 columns of text on your Apple He 
depends on which operating system you plan to use. Starting up the system 
with Apple II Pascal or CP/M® is very easy; the operating system does it for 
you; the procedures for starting up with ProDOS or DOS 3.3 are slightly 
more complicated, but not difficult. 



Starting Up With Pascal or CP/M 



Refer to the operating system reference 
manual for your version of Apple Pascal for 
more information. 



Pascal programmers don't have to activate the text card because Pascal 
does it for them. If you use the Pascal language or the CP/M operating 
system, displaying 80 columns of text is automatic once you've installed the 
card. Simply start up your system with any Pascal or CP/M startup disk. 

CP/M: CP/M (Control Program for Microprocessors) is a trademark of 
Digital Research. To use the CP/M operating system with your Apple lie, 
make sure the SOFTCARD® by Microsoft or the Z-Engine™ by Advanced 
Logic Systems is correctly installed before you start up the computer. 

Co-Processor Cards and Interrupts: Some co-processor cards that 
were designed for use in the Apple II Plus may not work with an Apple He 
without some modification. There could be problems if you want to use 
interrupts on the Apple lie. If you are having problems with a coprocessor 
card, check with the card's manufacturer for their recommendations. 

When using Apple II Pascal 1.1, you'll probably want to run the program 
SETUP to make the [Q and (T) keys functional. SETUP is a 
self-documenting program on the Pascal disk APPLE3. Pascal versions 1.2 
and later are already configured to use the (T) and (T) keys. 
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Starting Up With ProDOS or DOS 3.3 

ProDOS and DOS 3.3 both look for a startup program on the startup (boot) 
disk as soon as the operating system has been loaded and begins executing. 
If the operating system finds the program, called STARTUP on a ProDOS 
disk and usually called HELLO on a DOS 3.3 disk, it will execute the 
program. 

You can write a customized startup program that will set up the 80-column 
text card in any state you need. Just be sure it is on your startup disk and 
has the startup filename. 

Here is a sample Applesoft startup program that works with both ProDOS 
and DOS 3.3: 

10 HDME:D*-CHR$<4> 
20 PRINT D$;"PR*3" 
30 END 

You can do whatever you wish with the program from line 20 on. Note that 
the screen will have switched to 80-column text mode after line 20. 

By the Way: If you arrange to have the card active automatically, you 
will still, of course, be able to switch into 40-column mode. 



Using the GET Command 



The presence of an active 80-column text card in the He requires that 
BASIC programmers use some alternate to Applesoft's INPUT command if 
their programs are to be userproof . Applesoft programmers should use 
either the GET command or the RDKEY or GETLN subroutines. 

This is because the escape sequences used to switch back and forth 
between modes or to deactivate the card sometimes make it necessary to 
accept escape sequences in INPUT mode when using an 80-column card. 
Because the program accepts escape sequences typed from the keyboard, 
your program will not be userproof against accidental sequences typed in 
response to an INPUT command. 

To get around this problem, you can use the GET command instead. The 
program does not read escape sequences typed from the keyboard in 
response to a GET command, This means that your users can err in their 
responses without endangering the display. 



Using the GET Command 



Original lie 



When to Switch Modes Versus When to Deactivate 

When using BASIC, deactivate the text card whenever a previous (BASIC) 
program has left the card active (leaving a solid cursor on the screen) or 
whenever you want to send output to a peripheral device. 

Switch back and forth between 40-column and 80-column displays for 
visual appeal. For full use of the control characters described later, your 
card must be active, although it can display in either 40-column or 
80-column mode. 

Tabbing in Applesoft: You must switch to a 40-column display to use 
Applesoft comma tabbing or the HTAB command. 



Display Features With the Text Card 

With an active 80-column card you can issue BASIC and PRODOS 
commands in lowercase characters. You can also issue commands in 
lowercase from the keyboard, that is, in immediate mode. This is 
particularly convenient because REM statements and data within quotes 
remain in lowercase as they were typed, 

If you are using DOS 3.3, you must issue commands in uppercase whether 
or not your card is active. 



INVERSE, FLASH, NORMAL, HOME 

There are several commands you can give your computer from Applesoft 
BASIC to affect the appearance of text on the screen. All of these features 
are described in the Applesoft BASIC Programmer's Reference Manual. 

□ INVERSE tells the computer to display black characters on a white 
background instead of the normal display of white characters on a black 
background. This command is normally only available for uppercase 
characters, but with an active 80-column text card it is available for 
uppercase and lowercase characters. 

□ FLASH causes subsequently printed characters to blink quickly between 
inverse and normal characters. You can turn off the FLASH command by 
typing the NORMAL command. The FLASH command is normally 
available only with uppercase characters; it is not available at all while 
the card is active. 
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Important! 



d NORMAL tells the computer to turn off the INVERSE or FLASH 
command and to display subsequently printed characters normally. It 
works the same way with the card active or inactive. 

a HOME clears the screen and returns the cursor to the upper-left corner of 
the screen, Both the NORMAL HOME and INVERSE HOME commands 
are available while the card is active, but INVERSE HOME works a little 
differently when the card is active. 

By the Way: The FLASH and INVERSE commands can be used to 
highlight important screen messages within a BASIC program, 

If you are using the FLASH command (which means the 80-column text 
card is inactive) and then type PR#3 to activate the card, the screen 
turns white as the cursor goes to the HOME position. Whatever you type 
appears in black characters on the white screen. If you list or run an 
Applesoft BASIC program, some of the characters will appear as 
MouseText characters. To avoid this, remember to use either the 
NORMAL or INVERSE command before you exit the program. 



Tabbing With the Original Apple He 

You cannot use conventional 40-column tabbing in BASIC with the original 
model Apple He with an 80-column display. You do not have to turn off your 
card, but you must switch out of 80-column mode to use the HTAB 
command or to use comma tabbing, 

When an original Apple lie is displaying 80-column text, you should use the 
POKE 1403 command for horizontal tabbing in the right half of the screen 
instead of the HTAB command. 



Comma Tabbing With the Original Apple He 

In BASIC you can use commas in PRINT statements to instruct the 
computer to display all or part of your output in columns. This is known as 
comma tabbing. You can use this method of tabbing as long as the screen is 
displaying 40 columns (that is with the card inactive or after issuing an 
1 escape H T1 command to switch to 40-column mode). You cannot use this 
method of tabbing with an 80-column display. If you try to do so, characters 
will be placed in memory outside the screen area and may change programs 
or data in memory. 



Tabbing With the Original Apple He 
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HTAB and POKE 1403 

The VTAB (vertical tab) and HTAB (horizontal tab) statements can be used 
to place the cursor at a specific location on the screen before printing 
characters. The largest value you can use with the VTAB statement is 24; 
the largest for HTAB is 255. The VTAB command works just the same in an 
80-column display as it does in a 40-eolumn display. 

On the original Apple He, the HTAB command causes the cursor to wrap 
around to the next line after it reaches the 40th column, so you cannot use 
this command to position the cursor in the last 40 columns while the screen 
is displaying 80 columns. 

POKE 1403 is specifically designed to solve this problem. Using the 
POKE 1403 command allows you to tab horizontally across the extra 40 
columns provided by the 80-column text card. 

If you want to tab past column 40 while the card is active and the screen is 
displaying 80 columns, use the following, where n is a number from to 79: 

POKE 1403, n 

When you use the HTAB command, HTAB 1 places the cursor at the 
leftmost position on the screen. When you use the POKE 1403 command, 
POKE 1403,0 places the cursor at the leftmost position on the screen. 



Using Control Characters With the Card 

Using BASIC with an active 80-column text card increases the number of 
functions you can perform with control characters. Originally 
control-character commands were so named because they were given from 
the keyboard by pressing the [ control [ key in conjunction with another key. 
You can perform the same functions from 3 r our programs by using an 
equivalent control-character code. Commands based on these two-key 
combinations are caDed control-character commands even when they must be 
issued from a program. 
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Control Characters and Their Functions 

Table G-l lists the control-character commands supported by BASIC with 
an 80-colurrm card. The table includes the corresponding command code, its 
function and whether a given command can be executed from the keyboard 
as well as from a program. 

Table G-l. Control Characters With 80-Column Firmware On 



Control 


ASCII 


Apple He 


Character 


Code 


Name 


Control-G 


BEL 


bell 


Control-H 


BS 


backspace 


Control -J 


LF 


line feed 



Control-Kt VT clear EOS 

Control-Lt FF home 

and clear 

Control-M CR return 



Control- N t 
Control-0 1 
Control-Q t 
Control-R t 
Control-S * 



50 normal 

51 inverse 
DC1 40-column 
DC2 80-column 
DC3 stop-list 



Control-U t NAK quit 
Control-Vt SYN scroll 

Control-Wt ETB scroll-up 



Control-X CAN disable 

MouseText 



Action Taken by BASICOUT 

Produces a 1000 Hz tone for 0.1 second. 

Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 

Moves cursor position down to next line in 
window; scrolls if needed. 

Clears from cursor position to the end of 
the screen. 

Moves cursor position to upper-left corner 
of window and clears window. 

Moves cursor position to left end of next 
line in window; scrolls if needed. 

Sets display format normal. 

Sets display format inverse. 

Sets display to 40-column. 

Sets display to 80-column. 

Stops listing characters on the display 
until another key is pressed. 

Deactivates 80-column video firmware. 

Scrolls the display down one line, leaving 
the cursor in the current position. 

Scrolls the display up one line, leaving the 
cursor in the current position. 

Disable MouseText character display; use 
inverse uppercase. 
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Table G-l— Continued. Control Characters With 80-Column Firmware On 



Control 
Character 


ASCII 
Code 


Apple He 
Name 


Control-Y t 


EM 


home 


Control-Zt 


SUB 


clear line 


Control-f 


ESC 


enable 
MouseText 


Control- \t 


PS 


forward 
space 


Control-It 


GS 


clear EOL 


Control-— 


US 


up 


* Only works from the keyboard. 


t Doesn't work from the keyboard. 



Action Taken by BASICOUT 

Moves cursor position to upper-left corner 
of window (but doesn't clear). 

Clears the line the cursor position is on. 

Map inverse uppercase characters to 
MouseText characters. 

Moves cursor position one space to the 
right; from right edge of window, moves it 
to left end of line below. 

Clears from the current cursor position to 
the end of the line (that is, to the right 
edge of the window). 

Moves cursor up a line, no scroll. 



How to Use Control-Character Codes in Programs 

To issue a control-character command from a program, use the ASCII 
decimal code that corresponds to the control-character. (See Table G-l.) 

The following example shows how to use ASCII decimal codes in an 
Applesoft BASIC program. Type 

home m 

NEW 

10 PRINT CHRSC15): PRINT "MAKE HAY" 

20 PRINT CHR$C14>: PRINT "WHILE THE SUN SHINES" 

RUN 

(CHRS is the Applesoft BASIC command that signifies that a 
control-character function is to be performed.) 
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You will get 



] NEW 








llf PRINT 


CHR*C15>: PRINT 


"MAKE HAV" 




12f PRINT 


CHR$C14>: PRINT 


"WHILE THE SUN SHINES" 




1RUN 








MAKE HAY 








WHILE THE 


SUN SHINES 






!■ 




■ ; ■" ! % '■-'■ i l]l - I : 


i! ; :i ;;< 



See Chapter 3 in this manual for a 
description of control-character functions. 



The ASCII decimal codes for inverse video (Control-0) and normal video 
(Control-N) are 15 and 14. When the PRINT statements in the example are 
executed, the display switches to inverse and prints MAKE HAY, then 
switches back to a normal display and prints WHILE THE SUN SHINES. 



A Word of Caution to Pascal Programmers 

Avoid writing Control-U or Control-Q to the console from a Pascal program. 
Either one puts the system into a state that will cause Pascal to eventually 
crash. 

You can't send control characters from the keyboard to the 80-column 
firmware when using Pascal. The only exceptions to this rule are Control-M 
(CR)andControl-G(BEL). 
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For more information about the installation 
and operation of the SSC, see the Super 
Serial Card manual. 



The Pascal 1,1 firmware protocol is 
described in Chapter 6. 
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This appendix briefly describes how to use the Apple II Super Serial Card 
(SSC) from programs, how to find the SSC through software, and the 
commands supported by the SSC. 

The SCC is one of the most common serial interface cards used with the 
Apple He, and the Apple He's serial ports operate very much like the Super 
Serial Card. This similarity should make it easier for you to write programs 
for both the Apple lie and Apple lie. 



Locating the Card 



Locations $Cs05, $Cs07, $CsOB, and $CsOC (where s is the number of the 
slot where the SSC is installed) contain the identification bytes for the 
Super Serial Card. The identification byte's values are 



$Cs05 


$38 


$CsQ7 


$18 


$CsOB 


$01 


$CsOC 


$31 



Operating Modes 



The Super Serial Card has two main operating modes: printer mode and 
communications mode. There is nothing you can do from software to 
change from one mode to the other since they are set by the position of the 
jumper block. 

Note to Software Developers: If you are writing software that depends 
on the SSC being in a given operating mode, make sure that your 
documentation tells the user to set up the SSC in the proper way. 

In printer mode, the SSC is set to send data to a printer, local terminal, or 
other serial device. In communications mode, the SSC is set to operate with 
a modem. From communications mode, the SSC can enter a special mode 
called terminal mode. In terminal mode the Apple He acts like an 
unintelligent terminal. 
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Operating Commands 



Important! 



For each of the operating modes, you can control many aspects of data 
transmission such as baud rate, data format, line feed generation, and so 
forth. 

Your program can change these aspects by sending control codes as 
commands to the card. All commands are preceded by a command 
character and followed by a carriage return character (SOD). 

The command character is usually Control-I in printer mode and Control-A 
in communications mode and terminal mode. In the command examples in 
the following sections, Control-I is used unless the command being 
described is available only in communications mode or terminal mode. A 
carriage return character is represented by its ASCII symbol, CR. 

There are three types of command formats: 

□ A number, represented by n, followed by an uppercase letter with no 
space between the characters (for example, 4D to set data format 4). 

□ An uppercase letter by itself (for example, R to reset the SSC). 

□ An uppercase letter followed by a space and then either E to enable or D 
to disable a feature (for example, L D to disable automatic insertion of 
line feed characters). 

The allowable range of n is given in each command description that follows. 

The choice of enable or disable is indicated with E/D. The underscore 
character (_) before the E/D in commands that allow enable/disable is to 
remind you that a space is required there. 

The SSC checks only numbers and the first letters of commands and 
options. (All such letters must be uppercase.) Further letters, which you 
can add to assist your memory, have no effect on the SSC, For example, 
XOFF Enable is the same as X E. The SSC ignores invalid commands. 

The spaces in command examples are there for clarity; generally you will 
not use spaces in a command string. Where a space is required in a 
command string, an underscore (__) character will appear in the text as a 
reminder. 
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The Command Character 

The normal command character is Control-I (ASCII $09) in printer mode, or 
Control-A (ASCII $01) in communications mode. If you want to change the 
command character from Control -I to Control-something else, send Control-I 
Control-something else. For example, to change the command character to 
Control- W, send Control-I Control-W. To change back, send Control-W 
Control-1. No return character is required after either of these commands. 

You can send the command character itself through the SSC by sending it 
twice in a row: Control-I Control-I; no return character is required after this 
command. This special command allows you to transmit the command 
character without affecting the operation of the SSC, and without having to 
change to another command character and then back again later. 

Here is how to generate this character in BASIC and Pascal; 



Applesoft BASIC: 
Pascal: 



print CHRJCSjj-command" 
writeln cchr«9>, 'command') i 



Baud Rate, nB 

You can use this command to override the physical settings of switches 
SW1-1 through SW1-4 on the SSC. For example, to change the baud rate to 
135, send Control-I 4B CR to the SSC. 



Table H-l. Baud Rate Selections 



n 


SSC Baud Rate 


B 


SSC Baud Rate 





useSWl-ltoSWl-4 


8 


1200 


1 


50 


9 


1800 


1 


75 


LO 


2400 


3 


109.92(110) 


11 


3600 


4 


134.58(135) 


12 


4800 


5 


150 


13 


7200 


6 


300 


14 


9600 


7 


600 


15 


19200 



.- 
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Data Format, nD 

You can override the settings of switch SW2-1 with this command. The 
table below shows how many data and stop bits correspond to each value 
of n. For example, Control-1 2D CR makes the SSC transmit each character 
in the form one start bit (always transmitted), six data bits, and one stop 
bit. 

Table H-2. Data Format Selections 

n Data Bits Stop Bits 






8 


1 


1 


7 


1 


2 


6 


1 


3 


5 


1 


~ 


8 


2" 


5 


7 


2 


6 


6 


2 


7 


5 


2t 



* 1 with Parity options 4 through 7 
1 1H with Parity options through 3 



Parity, nP 



You can use this command to set the parity that you want to use for data 
transmission and reception. There are five parity options available, 
described in Table H-3. 



Table H-3. Parity Selections 



0,2,4or6 

I 
3 

5 
7 



Parity to Use 

None (default value) 
Odd parity (odd total number of ones) 
Even parity (even total number of ones) 
MARK parity (parity bit always 1) 
SPACE parity (parity bit always 0) 
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For example, the command string Control-I IP CR makes the SSC transmit 
and check for odd parity. Odd parity means that the high bit of every 
character is if there is an odd number of 1 bits in that character, or 1 if 
there is an even number of 1 bits in the character, making the total number 
of 1 bits in the character always odd, This is an easy (but not foolproof) way 
to check data for transmission errors. Parity errors are recorded in a status 
byte. 



Set Time Delay, nC, nl_, and nF 

Some printers can't keep up with the Apple He when they are doing certain 
operations. You may need to change default settings on the SSC to give a 
printer the time it needs. 

The nC command overrides the setting of switch SW2-2 on the SSC. That 
switch provides two choices: either no delay or a 250 millisecond delay after 
the SSC sends a carriage return character. 

The nL command allows time after a line feed character for a printer platen 
to turn so the paper is vertically positioned to receive the next line. 

The nF command allows time after a form feed character for the printer 
platen to move the paper form to the top of the next page (typically a longer 
time than a line feed). 

Table H4. Time Delay Selections 



It 


Time Delay 





none 


1 


32 milliseconds 


2 


250 milliseconds (1/4 second) 


3 


2 seconds 



£1 
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Consult the user manual for a given printer to find out how much time it 
takes to move its print head and platen so you can determine an appropriate 
set of values for these three delays. The idea is to have at least enough time 
for the printer parts to move the required distance, but not so much time 
that overall printing speed is slowed down drastically. Many printers 
require no delays because they have a buffer built in to keep accepting 
characters even while they are doing form feeds and so on. 

A typical setup for a very slow printer would be Control-1 2C CR, 
Control-1 2L CR, Control-1 3F CR; that is, the SSC waits 250 milliseconds 
after transmitting carriage returns, 250 milliseconds after transmitting line 
feeds, and 2 seconds after transmitting form feed characters. 



Echo Characters to the Screen, E_E/D 

For the Apple He, as for most computers, displaying (echoing) a character 
on the video screen during communications is a separate step from 
receiving it from the keyboard, though we tend to think if these as one step, 
as on a typewriter. For example, if you send Control-A EL_D CR, the SSC 
does not forward incoming characters to the Apple He screen. This can be 
used to hide someone's password entered at a terminal, or to avoid double 
display of characters. 

This command is used in communications mode only. 



Important! 



Automatic Carriage Return, C 

Sending Control-I C CR to the SSG causes it to generate a carriage return 
character (ASCII CR) whenever the column count exceeds the current 
printer line width limit. This command is used in printer mode only. 

Once this option is on, only clearing the high-order bit at location $578+s 
(where s is the slot the SSC is in) can turn this option back off. This 
option is normally off. 
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Automatic Line Feed, I E/D 

You can use this command to have the SSC automatically generate and 
transmit a line feed character after each carriage return character. This 
overides the setting of switch SW2-5. For example, send Control-I L_E CR 
to your printer to print listings or double-spaced manuscripts for editing. 



Mask Line Feed In, M_E/D 

If you send Control-I M_E CR to the SSC, it will ignore any incoming line 
feed character that immediately follows a carriage return character. 



Reset Card, R 

Sending Control-I R CR to the SSC has the same effect as sending a PR#0 
and an IN#0 to a BASIC program and then resetting the SSC. This 
command cancels all previous commands to the SSC and puts the physical 
switch settings back into force. 



Specify Screen Slot, S 

In communications mode, you can specify the slot number of the device 
where you want text or listings displayed with this command. (Normally 
this is slot 0, the Apple He video screen.) This allows chaining of the SSC to 
another card slot, such as an 80-column text card. For the firmware in the 
SSC to pass on information to the firmware in the other card, the other card 
must have an output entry point within its SCsOO space; this is the case for 
all currently available 80-column cards for the Apple lie. 

For example, let's say you have the SSC in slot 2 with a remote terminal 
connected to it, and an 80-column card in slot 3. Send Control-A 3S CR to 
cause the data from the remote terminal to be chained through the card in 
slot 3, so that it is displayed on the Apple He in 80-column format. (Not 
available in Pascal.) 



Translate Lowercase Characters, nT 

The Apple He Monitor translates all incoming lowercase characters into 
uppercase ones before sending them to the video screen or to a BASIC 
program. The nT command has four options, which are shown in Table H-5. 
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Table H-5. Lowercase Character Display Options 



n Action 

Change all lowercase characters to uppercase ones before passing 
them to a BASIC program or to the video screen. This is the way the 
Apple He monitor handles lowercase. 

1 Pass along all lowercase characters unchanged. The appearance of 
the lowercase characters on the Apple II screen is undefined 
(garbage). 

2 Display lowercase characters as uppercase inverse characters (that 
is, as black characters on a white background). 

3 Pass lowercase characters to programs unchanged, but display 
lowercase as uppercase, and uppercase as inverse uppercase (that is, 
as black characters on a white background). 



Important! 



Suppress Control Characters, Z 

If you issue the Z command described here, all further commands are 
ignored; this is useful if the data you are transmitting, such as graphics 
data, contains bit patterns that the SSC can mistake for control characters. 

Sending Control-! Z CR to the SSC prevents it from recognizing any further 
control characters (and hence commands) whether coming from the 
keyboard or contained in a stream of characters sent to the SSC. 

The only way to reinstate command recognition after the Z command is 
to either reinitialize the SSC, or clear the high-order bit at location 
S5F8+S (where s is the number of the slot in which the SSC is installed). 



Find Keyboard, F_E/D 

You can use this command to make the SSC ignore keyboard input. 

For example, you can include Control-I F_D CR in a program, followed by a 
routine that retrieves data through the SSC, followed by Control-I F_E CR 
to turn the keyboard back on. 



Operating 



285 



Caution 



XOFF Recognition, X_E/D 

Sending Control-I X„E CR to the SSC causes it to look for any XOFF ($13) 
character coming from a device attached to the SSC, and to respond to it by 
halting transmission of characters until the SSC receives an XON ($11) 
from the device, signalling the SCC to continue transmission, In printer 
mode, this function is normally turned off. 

In printer mode, full duplex communication may not work with XOFF 
recognition turned on, so be careful. 



Tab in BASIC, T E/D 

In printer mode only, if you send Control-I T_E CR to the SSC, the BASIC 
horizontal position counter is left equal to the column count. All tabs work, 
including back-tabs. Tabs beyond column 40 require a POKE to location 36, 
Commas only work as far as column 40, and BASIC programs will be listed 
in 40-column format. 

Note that this use of tabbing is specific to the SSC— it doesn't go through 
the 80-column firmware. 



Terminal Mode 



From communications mode, the SSC can enter terminal mode and make 
the Apple lie act like an unintelligent terminal. This is useful for connecting 
the Apple He to a computer timesharing service, or for conversing with 
another Apple II. 



Entering Terminal Mode, T 

Send Control- A T CR to enter terminal mode. This causes the Apple He to 
function as a full-duplex unintelligent terminal. You can use this command 
together with the Echo command to simulate the half-duplex terminal mode 
of the old Apple II Communications Card. 

By the Way: If you enter terminal mode and don't see what you type 
echoed on the Apple video screen, probably the modem link has not yet 
been established, or you need to use the Echo Enable command 
(Control-A E_E CR), 
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Transmitting a Break, B 

Sending Control-A B CR causes the SSC to transmit a 233-millisecond break 
signal, recognized by most time-sharing systems as a signoff . 



Spe cial Characters, S_E/D 

If you send Control-A S_D CR, the SSC will treat the l escape l key like any 

other key. 



Quitting Termina l Mode, Q 

Send Control-A Q CR to the SSC to exit from terminal mode. 



SSC Error Codes 

The SSC uses I/O scratchpad address $678+ s (s is the number of the slot 
that the SSC is in) to record status after a read operation, The firmware 
calls this byte STSBYTE, Table H-6 lists the bit definitions of this byte. 

Table H-6. STSBYTE Bit Definitions 



Bit 


"1" Means 


"0" Means 





Parity Error occurred. 


No Parity Error occurred. 


I 


Framing Error occurred. 


No Framing Error occurred. 


2 


Overrun occurred. 


No Overrun occurred. 


3 


Carrier lost. 


Carrier present. 


5 


Error occurred, 


No error occurred. 



The terms Parity, Framing Error, and Overrun are defined in the 

glossary. 

Bits 0, 1, and 2 are the same as the corresponding three bits of the ACIA 
Status Register of the SSC. Bit 3 indicates whether or not the Data Carrier 
Detect (DCD) signal went false at any time during the receive operation. 
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Bit 5 is set if any of the other bits are set, as an overall error indicator. If 
bit 5 is the only bit set, an unrecognized command was detected. If all bits 
are 0, no error occurred. 

These error codes begin with the number 32 to avoid conflicting with 
previously defined and documented system error codes. 

In BASIC, you can check this status byte via a PEEK $678+s (s is the SSC 
slot), and reset it with a POKE command at the same location. 

In Pascal, the IORESULT function returns the error code value. 

By the Way: Any character— including the carriage return at the end of 
a WRITELN statement— will cause posting of a new value in IORESULT. 

Table H-7 shows the possible combinations of error bits corresponding to 
these decimal error codes. 



Table H-7. Error Codes and Bits 



Error 


Carrier 






Framing 


Parity 


Code* 


Lost 


Overrun 


Error 


Error 









no error 




32 




illegal command 




33 


no 


no 




no 


yes 


34 


no 


no 




yes 


no 


35 


no 


no 




yes 


yes 


36 


no 


yes 




no 


no 


37 


no 


yes 




no 


yes 


3* 


no 


yes 




yes 


no 


39 


no 


yes 




yes 


yes 


40 


yes 


nc 




no 


no 


41 


yes 


no 




no 


yes 


42 


yes 


no 




yes 


no 


43 


yes 


r.. 




yes 


yes 


44 


yes 


yes 




no 


no 


45 


yes 


yes 




no 


yes 


4^ 


yes 


yes 




yes 


no 


4" 


yes 


yes 




yes 


yes 



* Result of PEEK $678+s in BASIC or IORESULT in Pascal. 
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The AC1A 

The Asynchronous Communication Interface Adapter (ACIA) chip is the 
heart of the Super Serial Card. It takes the 1.8432 MHz signal generated by 
the crystal oscillator on the SSC and divides it down to one of the fifteen 
baud rates that it supports. The ACIA also handles all incoming and 
outgoing signals of the RS232-C serial protocol that the ACIA supports. 

The ACIA registers control hardware handshaking and select the baud rate, 
data format, and parity. The ACIA also performs parallel to serial and serial 
to parallel data conversion, and buffers data transfers. 



SSC Firmware Memory Use 



Table H-8 is an overall map of the locations that the SSC uses, both in the 
Apple He and in the SSC's own firmware address space. 



Table H-8. Memory Use Map 



Address 


Name of Area 


$0000-$OOFF 


Page zero 


$04xx-$07xx 

(selected 

locations) 


Peripheral slot 
Scratchpad RAM 


$C0(8+s)0- 
$C0(8+s)F 


Peripheral card I/O 
space 


$CsOO$CsFF 


Peripheral card 
ROM space 


$C800-$CFFF Expansion ROM 



Contents 

Monitor pointers, I/O hooks, and temporary 
storage. 

Locations (8 per slot) in Apple lie pages $04 
through $07. SSC uses all 8 of them. 

Locations (16 per slot) for general I/O; SSC 
uses 6 bytes. 

One 256-byte page reserved for card in slot s; 
first page of SSC firmware, 

Eight 256-byte pages reserved for 2K ROM or 
PROM; SSC maps its firmware onto 
$C800-$CEFF. 
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Zero-Page Locations 

The SSC uses the zero-page locations described in Table H-9. 



Table H-9. Zero-Page Locations Used by the SSC 



Address Name Description 

$24 * CH Monitor pointer to current position of cursor on 

screen 

$26 SLOT16 Usually (slot x 16); that is, $s0 

$27 CHARACTER Input or output character 

$28 * BASL Monitor pointer to current screen line 

$2A ZPTMP1 Temporary storage (various uses) 

$2B ZPTMP2 Temporary storage (various uses) 

$35 ZPTEMP Temporary storage (various- uses) 

$36 * CSWL BASIC output hook (not for Pascal) 

$37 * CSWH High byte of CSW 

$38 * KSWL BASIC input hook (not for Pascal) 

$39* KSWH High byte of KSW 

$4E * RNDL Random number location, updated when looking for 

a keypress (not used when initialized by Pascal) 

* Not used when Pascal initializes SSC. 



Peripheral Card I/O Space 

There are 16 bytes of I/O space allocated to each slot in the Apple He, Each 
set begins at address $C080 + (slot x 16); for example, if the SSC is in slot 3, 
its group of bytes extends from $C0B0 to SCOBF. Table H-10 interprets the 6 
bytes the SSC uses. 



290 



Appendix H: Programming With the Super Serial Card 



Table H-10. Address Register Bits Interpretation 



Address Register Bits Interpretation 



$C081+sQDIPSWl 
(SWl-x) 

$0082+sODIPSW2 
(SW2-x) 

$C088+sOTDREG 
RDREG 

$C089+sO STATUS 



$C08A+sOCOMMAND 



$C08B+sOCONTROL 



S Wl -6 is OFF when 1 , ON when 

1 SWl-5isOFFwhenl,ONwhenO 

4-7 Same as above for SW1-4 through SW1-1 

Clear To Send (CTS) is true when 
1-3 Same as above for SW2-5 through SW2-3 
5,7 Same as above for SW2-2 and SW2-1 

0-7 AC IA transmit register (write) 
0-7 ACIA receive register (read) 

ACIA status/reset register 

Parity error detected when 1 

1 Framing error detected when 1 

2 Overrun detected when 1 

3 ACIA receive register full when 1 

4 ACIA transmit register empty when 1 

5 Data Carrier Detect (DCD) true when 

6 Data Set Ready (DSR) true when 

7 Interrupt (IRQ) has occurred when 1 

ACIA command register (read/write) 

Data Terminal Ready (DTR): enable (1) 
or disable (0) receiver and all interrupts 

1 When 1 , allow STATU S bit 3 to cause interrupt 
2-3 Control transmit interrupt. Request To Send (RTS) 

level, and transmitter 
4 When 0, normal mode for receiver; when 1 , echo 

mode (but bits 2 and 3 must be 0) 
5-7 Control parity 

ACIA control register (read/write) 
0-3 Baud rate: $00 = 16 times external clock; See 

Table H-l, 
4 When 1, use baud rate generator; when 0, use 

external clock (not supported) 
5-6 Number of data bits: 8 (bit 5 and 6 - 0) 7 (5 = 1 , 

6 = 0), 6 (5 = 0, 6 = 1) or 5 (bit 5 and 6 both = 1) 
7 Number of stop bits: 1 if bit 7 = 0; 

if bit 7 = 1, then 1-1/2 (with 5 data bits, no parity), 

1 (8 data plus parity), or 2 
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Scratchpad RAM Locations 

The SSC uses the scratchpad RAM locations listed in Table H-ll. 



Table H-ll. Scratchpad RAM Locations Used by the SSC 



Address Fieldname Bit Interpretation 



$0478+s DELAYFLG 0-1 Form feed delay selection 

2-3 Line feed delay selection 

4-5 Carriage return delay selection 

6-7 Translate option 

$04F8+s PARAMETE 0-7 Accumulator for firmware's command processor 



$0578+8 STATEFLG 

$05F8+s CMDBYTE 

$0678+s STSBYTE 
$06F8+s CHNBYTE 

PWDBYTE 
$0778+ s BUFBYTE 

COLBYTE 
$07F8+s MISCFLG 



0-2 Command mode when not 

3-5 Slot to chain to (communications mode) 

6 Set to 1 after lowercase input character 

7 Terminal mode when 1 (communications mode) 
7 Enable CR generation when 1 (printer mode) 

0-6 Printer mode default is Control-I; communications 

mode default is Control-A 

7 Set to 1 to Zap control commands 

Status and IORESULT byte 

0-2 Current screen slot (communication mode); when 

slot = 0, chaining is enabled. 
3-7 $Cs00 space entry point (communications mode) 
0-7 Current printer width; for listing compensation, 

auto-CR (printer mode) 

0-6 One-byte input buffer (communications mode); 

used in conjunction with XOFF recognition 
7 Set to 1 when buffer full (communications mode) 
0-7 Current-column counter for tabbing and so forth 

(printer mode) 

Generate line feed after CR when 1 

1 Printer mode when 0; comminications mode when 1 

2 Keyboard input enabled when 1 

3 Control-S (XOFF), Control-R, and Control-T input 
checking when 1 

4 Pascal operating system when 1 ; BASIC when 

5 Discard tine feed input when 1 

6 Enable lowercase and special character generation 
when 1 (communications mode) 

6 Tabbing option on when 1 (printer mode) 

7 Echo output to Apple He screen when 1 
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Monitor ROM Listing 









^-Mv 




293 



00: 



0000 



1 TEST 



EQU 



:REAL VERSION 



0000; 
0000 ! 
0000: 
0000: 
S 

s 
s 
s 

0000: 
0000 : 
0000: 
0000 : 
0000; 
0000: 
0000: 
0000 : 
0000: 
0000: 
0000; 
0000: 
0000; 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000; 
0000: 
0000; 
0000: 
0000; 
0000; 
0000 ; 
0000; 
0000: 
0000; 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000; 
0000: 
0000: 
0000 : 
0000: 



0001 
0000 



F800 
C100 
C300 
C800 



0006 



COOO 
COOO 
C001 
C002 
C003 
C004 
CO 05 
C006 
C007 
COOS 
C009 
COOA 
COOB 
COOC 
COOD 
COOE 
COOF 
C010 

con 

C012 



2 
3 

u 
5 
6 
7 

9 
10 
11 

12 
13 
14 
L5 

16 
i 7 



IROTEST 

F80RG 
CI ORG 
C30RG 
C80RG 

F80RG 
CI ORG 
C30RG 
C80RG 



LST 

MSB 

EQU 

DO 

EQU 

EQU 

EQU 

EQU 

ELSE 

EQU 

EOU 

EQU 

EQU 

FIN 

MSB ON 

INCLUDE EQUATES 



ON 

ON 

1 

TEST 

SI 800 

$2100 

S2300 

S2800 

SF800 
$C100 
SC300 
$C800 



;D0 LISTING AND SYMBOL TABLES 
;SET THEM HIBITS 



I **************************************** 



* Apple //e Video Firmware 

* 

* RICK AURICCHIO 08/81 

* E. BEERNINK, R. WILLIAMS 1984 

* 

* (C) 1981,1984 APPLE COMPUTER INC. 

* ALL RIGHTS RESERVED 
* 
**************************************** 



2 

3 

4 

3 

~ 

7 

8 

9 

10 
11 

12 * 

13 G00DF8 

14 * 
15 

16 * 

17 KBD EQU $COO0 

18 CLR80C0L EQU SCOOO 

19 SET80C0L EQU $C001 

20 RDMAINRAM EQU $C002 

21 RDCARDRAM EQU $C003 

22 WRMAINRAM EOU $C004 

23 WRCARDRAM EQU $C005 

24 SETSLOTCXROM EQU $C006 

25 SET1NTCXR0M EQU $C007 

26 SETSTD2:P EQU $C008 

27 SETALTZP EQU $C009 

28 SETINTC3R0M EQU $C0OA 



EQU 6 



HARDWARE EQUATES: 



;F8 ROM VERSION 



;Read keyboard 

;Disable 80 column store 

;Enable 80 column store 

;Read from main RAM 

;Read from auxiliary RAM 

;Write to main RAM 

;Write to auxiliary RAM 

;Switch in slot CXOO ROM 

; Switch in internal CXOO ROM 

; Switch in main stack/zp/lang.card 

; Switch in aux stack/zp/lang.card 

; Switch In internal $C3 ROM 



29 SETSL0TC3ROM EQU $C00B ; Switch in slot $C3 space 



30 CLR80VID EQU SCOOC 

31 SET80VID EQU $C0OD 

32 CLRALTCHAR EQU $C00E 

33 SETALTCHAR EQU $C00F 

34 KBDSTRB EQU $C010 

35 RDLCBNK2 EQU $C011 

36 RDLCRAM EQU $C012 



;Dlsable 80 column video 
;Enable 80 column video 
; Normal Apple II char set 
;Norm/lnv LC, no flash 
;Clear keyboard strobe 
;>127 if LC BANK2 In use 
;>127 If LC is read enabled 
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0000 : 


C013 


37 


RDRAMRD 


EQU 


$C013 


0000: 


C014 


38 


RDRAMWRT EQU 


$C014 


0000: 


C015 


39 


RDCXROM 


EOU 


$C015 


0000: 


C016 


w 


RDALTZP 


EQU 


$C016 


0000: 


C017 


41 


RDC3R0M 


EQU 


SC017 


0000: 


C018 


42 


RD80C0L 


EQU 


$C018 


0000: 


C019 


43 


RDVBLBAR F.QU 


$C019 


0000: 


C01A 


44 


RDTEXT 


EQU 


$C01A 


0000: 


C01C 


45 


RDPAGE2 


EQU 


$C01C 


0000: 


C01E 


46 


ALTCHARSET EQU $C01E 


0000: 


COIF 


47 


RD80VID 


EQU 


$C01F 


0000: 


CO 30 


48 


SFKR 


EQU 


$C030 


0000: 


C054 


4 9 


TXTPAGE1 EQU 


$C054 


0000: 


C055 


50 


TXTPAGE2 EQU 


$C055 


oooo- 


C05D 


51 


CLRAN2 


EQU 


SC05D 


0000: 


C05F 


5 2 


CLRAN3 


EQU 


$C05F 


OOOO 


C061 


S3 


BUTNO 


EQU 


SC061 


0000. 


C062 


54 


BUTN1 


EQU 


SC062 


0000 


C081 


55 


ROM IN 


EQU 


$C081 


0000: 


C083 


56 


LCBANK2 


EOU 


$C083 


0000 


C08B 


57 


LCBANK1 


EQU 


SC08B 


0000: 




58 


* 






0000 




59 


* MONITOR EQUATES; 


oooo- 




60 


* 






0000 


FBB3 


61 


F8VERSI0N EQU F80RG+S 


0000 


FD1B 


62 


KEY IN 


EQU 


F80RG+S5 


0000 


FDFO 


63 


C0UT1 


EQU 


F80RG+S5 


0000 


FF69 


64 


MONZ 


EQU 


F80RG+$7 


0000 




65 


* 






0000 




n& 


* ZEROPAGE EQUATES: 


0000 




67 


* 






0000 


0000 


68 


LOCO 


EQU 





0000 


0001 


69 


LOCI 


EQU 


1 


0000 




7t 




DSECT 


0020 


0020 


71 




ORG 


S20 


0020 


: 0001 


72 


WNDLFT 


DS 




0021 


0001 


73 


WNDWDTH 


DS 




0022 


: 0001 


7 4 


WNDTOP 


DS 




0023 


0001 


7 3 


WNDBTM 


DS 




0024 


: 0001 


76 


CH 


DS 




0025 


0001 


77 


cv 


DS 




0026 


: 0002 


73 




DS 


2 


0028 


: 0002 


79 


BASL 


DS 


2 


002A 


: 0029 


80 


BASH 


EQU 


BASL+1 


002A 


: 0002 


81 


BAS2L 


DS 


2 


002C 


: 002B 


82 


BAS2H 


EQU 


BAS2L+1 


00 2C 




93 


* 






002F 


: 002 F 


84 




ORG 


$2F 


002 F 


: 0001 


85 


LENGTH 


rs 


1 


0030 


: 0002 


86 




DS 


2 


0032 


: 0001 


87 


INVFLG 


DS 


1 


0033 


: 0001 


8 8 


PROMPT 


DS 


1 


0034 


: 0001 


89 


YSAV 


DS 


1 


0035 


: 0001 


90 


SAVY1 


DS 


1 



;>127 if main RAM read enabled 

; > 1 27 if main RAM write enabled 

;>127 if ROM CX space enabled 

;>1 27 if alt. zp & lc enabled 

;>127 if slot C3 space enabled 

; >1 27 if 80 column store enabled 

;>127 if not vertical blanking 

;>127 if text mode 

;>127 if page 2 

; >1 27 if alt char set switched in 

;>127 if 80 column video enabled 

; toggle speaker 

; switches in text page 1 

;switches in text page 2 

jannunciator 2 

; annunciator 3 

;open-apple key 

;closed-apple key 

;swap in D000-FFFF ROM 

; swap in LC bank 2 

;swap in LC bank 1 



3B3 ;F8 ROM ID 

IB ; normal input 

FO ; normal output 

69 jraonitor entry point 



;used for doing PR# 
;used for doing PR# 



;scrolling window left 

; scrolling window width 

; scrolling window top 

; scrolling window bottom+1 

jcursor horizontal 

;cuisor vertical 

;GBASL,GBASR 

;points to current line of text 

[pointer used for scroll 



; length for mnemonics 

;>127=normal, <l27=inverse 
;used by monitor upshift 
;input buffer index for mini 
;for restoring Y 
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0036 : 
0038: 
0038: 
003A: 
003C: 
003C: 
003E; 
00 3E: 
0040 : 
0040: 
0042: 
0044: 
0044: 
004E: 
004E: 
O05O: 
0000: 
0000: 
0000: 
0000: 
0000; 
0000: 
0000 : 
0000: 
0000; 
0000 : 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000; 
0000: 
0000: 
0000: 
0000: 
0000: 



0002 
0037 
0002 
0039 
003C 
0002 
00 3D 
0002 
003F 
0002 
0002 
0043 
0001 
004E 
0002 
004F 



0200 



07 F8 

04 7 B 
04FB 
057B 
05FB 
067B 
06FB 
077B 
077B 
07 FB 
07FB 



91 

92 
93 

95 

9 b 
97 

; :/» 

99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 



CSWL 
CSWH 
KSWL 
KSWH 

AIL 
A1H 
A2L 
A2H 

A4L 
A4H 
MAC STAT DS 
ORG 



DS 

EQU 

DS 

EQU 

ORG 

DS 

EQU 

DS 

EQU 

DS 

DS 

EQU 



RNDL 
RNDH 



BUF 



DS 

EQU 

DEND 



2 

CSWL+1 

2 

KSWL+1 

$3C 

2 

A1L+1 

2 

A2L+1 

2 

2 

A4L+1 

1 

$4E 

2 

RNDL+1 



EQU $200 



;hook for output routine 
;hook for input routine 

;Monitor temps for MOVE 

;A3 NOT USED 

;machine state on breaks 
; random number seed 

; input buffer 



* Permanent data in screenholes 



Note: these screenholes are only used by 
the 80 column firmware if an 80 column card 
is detected or if the user explicitly activates 
the firmware. If the 80 column card is not 
present, only MODE is trashed on RESET. 

The success of these routines rely on the 
fact that if 80 column store Is on (as it 
normally is during 80 column operation), that 
text page 1 is switched in. Do not call the 
video firmware if video page 2 is switched in!! 



MSLOT EQU $7F8 
* 

OLDCH EQU $478+3 

MODE EQU $4F8+3 

OURCH EQU $578+3 

OURCV EQU $5F8+3 

CHAR EQU $678+3 

XCOORD EQU $6F8+3 

TEMPI EQU $778+3 

OLDBASL EQU $778+3 

TEMP2 EQU $7F8+3 

OLDBASH EQU $7F8+3 

BASIC MODE BITS 



;=$Cn ;n»slot using $C800 

;LAST CH used by video firmware 

;video firmware operating mode 

;80 column CH 

;80 column CV 

;character to be printed/read 

;G0T0XY X-coord (pascal only) 

l temp 

;last BASL (pascal only) 

; temp 

;last BASH (pascal only) 



0.. 
1., 
.0. 
.1. 

..0 

..1 



BASIC active 
Pascal active 



Print control characters 
Don't print Ctrl chars. 
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0000: 

0000: 

0000 i 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000; 

0000: 

0000: 

0000 

0000; 

0000; 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000; 

0000: 

0000: 

0000: 

0000; 

0000: 

0000: 

0000: 

0000: 

0000: 

0000 : 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000; 

C100: 
CI 00: 



0040 
0020 
0010 
0008 
0004 
0002 
0001 



0080 
0010 
0008 
0004 
0002 



FA47 
FC74 
FC7A 
F8B7 



NEXT OBJECT 
C100 
C100 



145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
18 
FILE 
1 
2 



6 

.CTL2 
4 
.CTL 

2 
.1 

MOUSE EQU 



.0. - 
.1. - 
..0 - 
..1 - 

EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



Print control characters 
Don't print next Ctrl char 



Mouse text inactive 
Mouse text active 



$40 
S20 

$10 
S08 
$04 
$02 
$01 



;Don't print controls 
;Temp ctrl disable 



Pascal Mode Bits 




1 

.0 

.1 

,.0 

. .1 



BASIC active 
Pascal active 



- Cursor always on 

- Cursor always off 

- G0TOXY n/a 

- G0TOXY in progress 

- Normal Video 

- Inverse Video 

- PASCAL 1.1 F/W ACTIVE 

- PASCAL 1.0 INTERFACE 

- Mouse text inactive 

- Mouse text active 



.PASCAL, EQU $80 

CURSOR EQU $10 
.GOXY EQU $08 

VMODE EQU $04 
.PAS1.0 EQU $02 



;Pascal active 
;Don't print cursor 
;G0TOXY IN PROGRESS 
; PASCAL VIDEO MODE 
; PASCAL 1.0 MODE 



* F8 ROM entries 
* 

NEWBREAK EQU F80RG+$247 
IRQUSER EQU F80RG+$474 
IRQD0NE2 EQU F80RG+$47A 
TSTR0M EQU F80RG+$B7 

INCLUDE BFUNC 
NAME IS REFLIST.O 

ORG CI ORG 
BFUNCPG EQU * 
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C100 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
ClOO 
C103 
C103 
C105 
C1Q7 
C108 
ClOB 
ClOE 
CllO 

cm 

C113 
C115 



FEC5 
FCFO 



4C 13 C2 

A4 24 

A5 25 

48 

20 03 CE 

20 F4 CI 

AO 00 

68 

69 00 

C5 23 

90 FO 



3 

4 
5 
6 

7 * 

8 * 



C107 



9 

10 
11 
!2 
13 
14 
15 
16 
17 
IS 
19 
20 
21 
22 
2 3 
Ik 
25 
2d 
2? 
28 
29 
30 
31 
32 
33 
u 
35 
36 
37 
38 
39 
40 
41 
^2 
43 
44 
45 
46 
47 
4B 
49 
50 
51 
52 
53 
54 
55 
56 



FUNCEX1T EQU F80RG+S6C5 ; RETURN ADDRESS 

MINI EQU F8ORG+S4F0 

* 

* BASIC FUNCTION HOOK: 



$C100 is called by the patched SF8 ROM. 

* It provides an extension to $F8 routines 

* that do not work in 80 columns. 
ft 

* Before jumping here, the $F8 rom disabled 

* slot I/O and enabled ROM I/O. This makes 

* the entire space from $C100 - $CFFF with the 

* exception of the SC300 page available. 

* 

* On exit slot I/O is restored if necessary. 

* INPUT: Y=FUNCTION AS FOLLOWS: 
* 

* 



KEY IN 

Fix escape char 

BASCALC 

VTAB or VTABZ 

HOME 

SCROLL 

CLREOL 

CLREOL2 

RESET 

CLREOP 

RDKEY 

SETWND 

Mini Assembler 

set 40 columns on PR#0/IN#0 

Fix pick for monitor 



* 

* 

* 

* Stack has PHP for status of internal SCNOO ROM 
* 

* Note: If 80 Vid is on and the MODE byte is valid, 

* this call will be dispatched to an 80 column routine 

* by B.FUNCO. Otherwise it will be dispatched to a 



40 column routine by 
to the Autostart ROM 



B.OLDFUNC. In all cases return 
is done through F. RETURN. 



B.FUNC JMP DISPATCH jfigure out what to do 



F. CLREOP LDY 
LDA 

CLEOPl PHA 
JSR 
JSR 
LDY 
PLA 
ADC 
CMP 
8CC 



CH 

cv 

VTABZ 
X.CLREOLZ 

#$00 

#$00 

WNDBTM 

CLEOPl 



ESC F IS CLR TO END OF PAGE 



;(carry set) 



:- 
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CU7 
C119 
C119 

cub 

CUD 
C11F 
C121 
C123 
C123 
C125 
C126 
C129 
C12B 
C12D 
C12F 
C131 
C133 
C134 
C135 
C137 
C139 
C13B 
C13C 
C13F 
C141 
C143 
C144 
C146 
C148 
C14A 
CUD 
C14F 
C152 
C152 
C152 
C154 
C156 
C158 
C15A 
CI5C 
C15E 
C160 
C160 
C160 
C160 
C162 
CL65 
C165 
C165 
C165 

:.-: 

C168 
C168 
C168 



BO 34 CUD 



A 5 
H5 
KG 
84 

FO 

A5 
48 

20 
AS 
85 
A5 
85 
A4 
88 
68 
69 

C5 

wo 

48 

20 
B] 

91 
88 
10 
30 
A0 
20 
45 
4C 



22 
25 
DO 

24 
E4 

22 



C107 



03 CE 

28 

2a 

29 

2B 

21 



M] 

23 

od 

03 CE 

28 

2A 

F'9 
El 
00 

F4 CI 
25 
03 CE 



C148 



C13F 
C129 



C152 



28 
21 
18 
23 
17 
25 
EF 



C14F 



2A 
F4 CL 



4C EB CB 



4C 9A CC 



57 

58 * 

59 F.HOME 
60 

61 

62 

63 

64 * 

65 

6b 

67 

68 SCRL1 

69 

70 

71 

72 

73 

74 

7 5 

76 

77 

78 

79 

80 SCRL2 



BCS GVTZ 



LDA 
STA 
LDY 
STY 
BEQ 



WNDTOP 

CV 

#$00 

CH 

CLE0P1 



=>always to VTABZ 



;( ALWAYS TAKEN) 



81 
8 2 
83 
84 



■SCROLL LDA WNDTOP 
PHA 
JSR 
LDA 
STA 
LDA 
STA 
LDY 
DEY 
PLA 
ADC 
CMP 
BCS 
PRA 
JSR 
LDA 
STA 
DEY 
BPL 
BMI 

85 SCRL3 LDY 

86 JSR 

87 GVTZ LDA 

88 GVTZ2 JMP 

89 * 
90 
91 
92 
93 
94 
95 
96 
9 7 
98 
99 

100 
101 
102 

103 * 

104 * 80 column routines beglri "here 

105 * 

106 B. SCROLL JMP SCROLLUP ;DO IT FOR CALLER 

107 * 

108 * Clear to end of line using Y = OURCH 

109 * 

110 B.CLREOL JMP X.GS jclear to end of line 



VTABZ 

BASL 

BAS2L 

BASH 

BAS2H 

WNDWDTR 



#$01 

WNDBTM 
SCRL3 

VTABZ 

(BASL),Y 

(BAS2L),Y 

SCRL2 

SCRL1 

#500 

X.CLREOLZ 

CV 

VTABZ 



;set vertical base 



F.SETWND EOU 
LDA 
STA 
LDA 
STA 
LDA 
STA 
BNE 



#40 

WNDWDTH 
#24 
WNDBTM 

#2 3 

CV 

GVTZ2 



;=>go do vtab, exit 



* Load Y from BAS2L and clear line 

F.CLREOLZ LDY BAS2L ;set up by 5F8 ROM 
JMP X.CLREOLZ ;and clear line 
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C16B 
CI6B 

C16B 

C16B 

C16B 

C16D 

C170 

C170 

C173 

CI76 

C179 

CL7C 

C17C 

C17F 

C182 

C184 

C187 

C18A 

CL8A 

C18A 

CL8A 

C18A 

C18A 

C18A 

C18C 

C18E 

G190 

C192 

C195 

C197. 

C199 

C19B 

G19D 

C19F 

C1AQ 

C1AO 

C1A2 

C1A4 

G1A6 

C1A9 

C1A9 

C1AB 

CI AD 

C1AE 

C1BQ 

C1B2 

C1B4 

C1B5 

C1B6 

C1B6 

C1B7 

C1B9 

C1BC 

C1BE 



Ai 
4C 

4C 
4C 
4C 
4C 

20 
AD 
85 
8D 
4C 



2A 
9D CC 

74 CC 
AO C2 
BO C2 
F2 C2 

90 CC 
7B 05 
24 

7B 04 
FE CD 



C18A 



B4 

FO 
CD 
FO 
20 
!S4 
FO 
A9 
95 
B5 
&Q 

A5 
C9 
DO 
4C 

A.4 
Bl 
48 

29 
09 

91 
bS 
60 

48 
h5 
20 
9Q 



C19D 



C1A0 



C19D 



00 

OF 

LI 

OE 

80 CD 

00 

04 

FD 

1 

01 



37 

C3 

F3 C199 

32 C8 

24 
28 

3F 
40 
2fi 



28 

BA CA 

4C C20A 



111 
112 
113 

114 

115 

116 

117 

118 

119 

120 

121 

122 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

135 

156 

157 

158 

159 

160 

161 

162 

163 

164 



* Clear to end of line using Y = BAS2L 

* which was set up by the $F8 ROM 

* 

B.CLREOLZ LDY BAS2L ;get Y 

JMP X.GSEOLZ ;clear to end of line 

B.CLREOP JMP X.VT ;CLEAR TO EOS 

B.SETWND JMP B.SETWNDX 

B. RESET JMP B.RESETX ;MUST BE IN BFUNC PAGE 

B.RDKEY JMP B.RDKEYX 



B.HOME JSR X.FF 

LDA OURCH 

STA CH 

STA OLDCH 

JMP VTAB 



;HOME & CLEAR 

;COPY CH/CV FOR CALLER 
; REMEMBER WHAT WE SET 
;calc base & return 



* Complete PRif or IN# call. Quit video firmware 

* if PR#0 and it was active (B.QUIT). Complete call 

* if inactive (F.QUIT). 



B.QUIT EQU * 

LDY LOCO.X 

BEQ NOTO 

CPY #KEYIN 

BEQ ISO 

JSR QUIT 

F.QUIT LDY LOCO.X 

BEQ NOTO 



;was it PR#0/IN#0? 

;=>no, not slot 

;was it IN#0? 

;=>yes, update high byte 

;quit the firmware 

;get low byte into Y 

;not slot 0, firmware inactive 



F8H00K LDA /iKKEYIN ;set high byte to $FD 

STA L0C1,X 

NOTO LDA LOCl.X ;restore accumulator 

RTS 

ISO LDA CSWH ;is SC3 in output hook? 

CMP KBASICIN 

BNE F8H00K ;=>no, set to $FD0C 

JMP C3IN ;else set to $C305, exit A=$C3 

F.RDKEY LDY CH ;else do normal 40 cursor 

LDA (BASL),Y ;grab the character 

PHA 

AND #$3F ;aet screen to flash 

ORA #$40 

STA (BASL),Y ;and display it 
F.NOCUR PLA 

RTS ; return (A=char) 

F. BASCALC TAX [restore Y 

LDA BASL ; restore A 

JSR BASCALC ;calculate base address 

BCC F. RETURN ; BASCALC always returns BCC ! 



:• 
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CI BE 
C1BE 
CLCl 
C1C3 
C1C3 
C1C6 
C1C8 
CICB 
C1CB 
C1CC 
C1CE 
C1D0 
C1DO 
C1D3 
C1D6 
C1D6 
C1D6 
C1D6 
C1D7 
C1D9 
C1DB 
C1DD 
C1DF 
C1E2 
C1E2 
C1E5 
C1E6 
C1E8 
C1E9 
C1E9 
C1E9 
C1E9 
C1EC 
C1EF 
C1F1 
C1F2 
C1F2 
C1F2 
C1F2 
CIF2 
C1F4 
C1F6 
C1F9 
C1FB 
C1FD 
C1FF 
C201 
C204 
C204 
C204 
C204 
C204 
C205 
C207 



CIBE 
20 14 CE 
AO 03 

C1C3 
D9 EE C2 
DO 03 CICB 
B9 A4 C9 

CICB 
88 

10 F5 C1C3 
30 3A C20A 

20 70 C8 
4C OA C2 



8A 

29 03 
85 2F 
A5 2A 
29 8F 
4C 71 CA 

20 FO FC 
8A 

85 34 
60 



AC 7B 05 

20 44 CE 
09 80 
60 



C1F2 



A4 24 
A9 AO 

2C IE CO 
10 06 
24 32 
30 02 
A9 20 
4C A8 CC 



C201 



C201 



A8 

A5 28 
20 03 CE 



165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
i82 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 



;upshlft lowercase 

;SCAN FOR A MATCH 



B. ESC FIX EQU * 

JSR UPSHFT 
B.ESCFIX1 LDY M-l 
B.ESCFIX2 EQU * 

CMP ESCIN.Y ;IS IT? 

8NE B.ESCFIX3 ;=>NAW 

LDA ESCOUT.Y ;YES, TRANSLATE IT 
B.ESCFIX3 EQU * 

DEY 

BPL B.ESCFIX2 

BMI F. RETURN ;RETURN:CHAR IN AC 
* 

F.BOUT JSR BOUT ;print the character 

JMP F. RETURN ;AND RETURN 
* 

* Do displaced mnemonic stuff 



MNNDX TXA 

AND #$03 

STA LENGTH 

LDA BAS2L 

AND #$8F 

JMP DOMN 

* 

GOMINI JSR MINI 
TXA 

STA YSAV 
RTS 



;get old ace 
;make it a length 

;get old Y into A 

;and go to open spaces 

;do mini-assembler 

;X=0. Set mode to 0, and counter 

;so not CR on new line 



* Pick an 80 column character for the monitor 



FIXPICK LDY OURCH 

JSR PICK 

ORA #$80 
RTS 



;get 80 column cursor 
;pick the character 
; always pick as normal 
;and return 



* Load CH into Y and clear line 

* 

F.CLRE0L EQU * 

X.CLRE0L LDY CH ;get horizontal position 

X.CLRE0LZ LDA #$A0 ; store a normal blank 

BIT ALTCHARSET ;unless alternate char set 

BPL X.CLREOL2 

BIT INVFLC ;and Inverse 

BMI X.CLREOL2 

LDA #$20 juse inverse blank 
X.CLRE0L2 JMP CLR40 ;clear to end of line 
* 

* Call VTAB or VTABZ for 40 or 80 columns. Ace (CV) 

* is saved in BASL. 
* 

F. VTABZ TA.Y ; res tore Y 

LDA BA.SL ;and A 
JSR VTABZ ;do VTABZ 
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301 



C20A 
C20A 
C20A 
C20A 
C20A 
C20A 
C20B 
C20D 
C210 
C213 
C213 
C213 
C213 
C213 
C2H 
C216 
C217 
C219 
C21A 
C21C 
C21D 
C21F 
C220 
C222 
C222 
C222 
C222 
C224 
C225 
C227 
C228 
C228 
C228 
C228 
C228 
C22B 
C22D 
C22F 
C230 
C231 
C233 
C234 
C237 
C23A 
C23B 
C23C 
C23C 
C23C 
C23C 
C23E 
C23F 
C242 
C243 
C243 



88 

30 
88 
30 

88 
30 
88 
30 
88 
30 



A9 
48 
AS 

48 



C20A 

03 C210 
C5 FE 

C8 FE 



BA CI DO 

A5 C1BE 

9A C1B6 

3D C25C 

E2 C204 

C2 
09 



FB 04 

D6 

OD C23C 



219 * 

220 * EXIT. EITHER EXIT WITH OR WITHOUT 

221 * ENABLING I/O SPACE. 

222 * 

223 F. RETURN EQU * 



OC 

50 C8 
FE CD 



CI 
44 C2 



GET PRIOR I/O DISABLE 
=>LEAVE IT DISABLED 
=>EXIT & ENABLE I/O 



224 PLP 

225 F.RET2 BMI F.RET1 

226 ,JMP FUNCEXIT 

227 F.RET1 JMP FUNCEXIT+3 ;EXIT DISABLED 

228 * 

229 * Do BOUT, ESCFIX, BASCALC, and KEY IN immediately 

230 * to avoid destroying Accumulator. 

231 * 

232 DISPATCH DEY 

;code = 80 column output 



BMI F.BOUT 

DEY 

BMI B. ESCFIX ;code 1 - ESCFIX 

DEY 

BMI F. BASCALC ;code 2 = BASCALC 

DEY 

BMI B.KEYIN ;code 3 = KEY IN 

DEY 

BMI F.VTABZ ;code 4 = VTABZ 



233 
234 
235 
236 
237 
238 
239 
240 
241 

242 * 

243 * First push address of generic return routine 

244 * 

245 LDA #<F. RETURN ;return to F. RETURN 

246 PHA 

247 LDA #>F. RETURN- 1 

248 PHA 

249 * 

250 * If any of 5 bits in S4FB (MODE) is on, then the mode is not 

251 * valid for video firmware. Use old routines. 

252 * 
LDA MODE ;no, is mode valid? 
AND //M.PASCAL+M.6+M.4+M.2+M.1 
8NE GETFUNC ;=>no, use 40 column routines 

;80 column routines In 
;2nd half of table 



253 
254 
255 

256 TYA 

257 CLC 

258 ADC #TABLEN 

259 PHA 

260 JSR CSETUP 

261 JSR VTAB 

262 PLA 

263 TAY 

264 * 

265 * Now push address of routine 

266 * 

267 GETFUNC LDA KBFUNCPG ; stuff routine address 

268 PHA 

269 LDA F. TABLE, Y 

270 PHA 

271 * 

272 * RTS goes to routine on stack. When the routine 



;set up 80 column cursor 
;calc base 

;restore Y 



. 
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C243 
C243: 
C243 
C243: 
C244 
C244; 
C244: 
C244: 
C244: 
C244: 
C245: 
C246: 
C247: 
C248: 

C249 
C24A 
C24B 
C24C 
C24D 
C24E 
C24F 
C250 
C250 
C250 
C250 
C251 
C252 
C253 
C254 
C255 
C256 
C257 
C258 
C259 
C25A 
C25B 
C25C 
C25C 
C25C 
C25F 
C261 
C264 
C267 
C2 67 
C268 
C269 
C26A 
C26B 
C26C 
C26D 
C26D 
C26E 
C270 



60 



L8 
22 

Fl 
5F 
75 

02 
A8 
51 
El 

9 4 

r8 

D5 



286 



C244 



000C 

64 
67 

6 A 
75 
6F 
78 
72 
El 
89 
E8 
DS 

C25C 
2C IF CO 
10 06 C267 
20 74 C8 
4C OA C2 

A8 
8 A 

4g 

98 
48 
48 

68 

C9 FF 

FO 04 C276 



273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 



does an RTS, it returns to F. RETURN, which restores 
the INTCXROM status and returns. 



RTS 



Table of routines to call. All routines are 
in the $C100 page. These are low bytes only. 

.TABLE E0U * 

DFB #>F.H0ME-1 ;(5) 40 column HOME 

DFB #>F.SCROLL-l ;(6) 40 column scroll 

DFB #>F.CLRE0L-1 ;(7) 40 column clear line 

DFB #>F.CLRE0LZ-1 ;(8) 40 column clear with Y set 



DFB 
287 
288 
289 
290 
291 
292 
293 

294 * 

295 TABLEN 

296 * 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 * 
310 
311 
312 
313 



#>B.RESET-I ;{9) 40/80 column reset 

DFB #>F.CLRE0P-1 ;(A) 40 column clear end of page 

DFB #>F.RDKEY-L ;(B) readkey w/flashing checkerboard 

DFB #>F.SETWND-1 ;(C) Set 40 column window 

DFB #>GOMINI-l ;(D) Mini-assembler 

DFB />>F.Q!JIT-1 ;(E) quit before IN#0,PR#0 

DFB #>FIXPICK-1 ;(F) fix pick for 80 columns 

DFB #>MNNDX-1 ;(10) calc mnemonic index 



EOU *-F. TABLE 



DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 



#>B.HOME-l ; 

#>B.SCR0LL-1 

#>B.CLREOL-l 

#>B,CLREOLZ- 

#>B.RESET-1 

#>B.CLREOP-l 

#>B.RDKEY-1 

#>B.SETWND-1 

#>GOMINI-l 

#>B.QUIT-1 

#>FIXPICK-1 

#>MNNDX-1 



317 
318 
319 
320 
321 

322 * 

323 NEW. CUR PLA 
CMP 
BEQ 



TXA 
PHA 
TYA 
PHA 
PHA 



(11) 80 column HOME 

;(12) 80 column scroll 

;(13) 80 column clear line 
1 ;(14) 80 column clear with Y set 
;(15) 40/80 column reset 

j (16) 80 column clear end of page 
;(17) readkey w/inverse cursor 

;(18) 40/80 column VTAB 
(19) Mini-Assembler 
(1A) quit before IN*0,PR#Q 
;(1B) fix pick for 80 columns 
(1C) calc mnemonic index 



B.KEYIN ECU 
BIT 
BPL 
JSR 

314 GOF.RET JMP 

315 * 

316 B. KEY INI TAY 



RD80VID 

B.KEYIN1 

BIN 



80 columns? 

=>no, flash the cursor 

get a keystroke 



F. RETURN ;and return 

;preserve A 

j put X on stack 



324 
325 



; re st ore A 

;save char on stack 

;dummy for cursor/char test 

;get last cursor 
#$FF ;was it checkerboard? 
NEW.CUR1 ;=>yes, get old char 
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303 



C272: 


A9 FF 




326 




LDA 


#SFF 


;no, get checkerboard 




C274; 


DO 02 


C278 


327 




BNE 


NEW.CUR2 


=>always 




C276: 


68 




328 


NEW.CUR1 PLA 




;Set character 




C277: 


48 




329 




PHA 




;into accumulator 




C278: 


48 




330 


NEW.CUR2 PHA 




;save for next cursor che 


ck 


C279: 


A4 24 




331 




LDY 


CH 


,get cursor horizontal 




C27B: 


91 28 




332 




STA 


(BASL),Y 


;and save char/cursor 




C27D: 






333 


* 










C27D: 






334 


* 


Now leave char/cursor 


for awhile or 




C27D: 






335 


■k 


until a key is pressed. 




C27D: 






336 


* 










C27D: 


E6 4E 




337 


WAITKEY1 


RNDL 


;bump random seed 




C27F: 


DO OA 


C28B 


338 




BNE 


WAITKEY4 


;=>atid check keypress 




C281: 


A5 4F 




339 




LDA 


RNDH 


;is it time to blink yet? 




C283: 


E6 4F 




340 




INC 


RNDH 






C285: 


45 4F 




341 




EOR 


RNDH 






C287: 


29 40 




342 




AND 


//$40 






C289 


DO E2 


C26D 


343 




BNE 


NEW. CUR 


;=>yes, blink it 




C28B: 


AD 00 


CO 


344 


WAITKEY4 LDA 


KBD 


; Ivories been tickled? 




C28E 


LO ED 


C27D 


345 




BPL 


WAITKEY1 


;no , keep blinking 




C290: 






346 


-V 










C2 90 


68 




347 




PLA 




;pop char/cursor 




C291: 


68 




348 




PLA 




;pop character 




C292 


A4 24 




349 




LDY 


CH 


;and display it 




C294 


91 28 




350 




STA 


(BASL),Y 


; (erase cursor - ) 




C296 


68 




351 




PLA 




jrestote X 




C297 : 


AA 




352 




TAX 








C298 


AD 00 


CO 


353 




LDA 


KBD 


;tiow retrieve the key 




C2 9B 


8D 10 


CO 


354 




STA 


KBDSTRB 


;clear the strobe 




C29E 


30 C4 


C264 


355 




BMI 


GOF.RET 


;=>exit always 




C2A0 






356 


* 










C2A0 




C2A0 


357 


B. 


SETWNDX EQU * 






C2A0 


20 52 


CI 


358 




JSR 


F.SETWND 


;set 40 column width 




C2A3 


2C IF 


CO 


359 




BIT 


RD80VID 


;80 columns? 




C2A6 


10 02 


C2AA 


360 




BPL 


SKPSHFT 


;=>no, width ok 




C2A8 


06 21 




361 




ASL 


WNDWDTH 


;make it 80 




C2AA 


A5 25 




362 


SKPSHFT LDA 


CV 






C2AC 


8D FB 


5 


363 




STA 


OURCV 


; update OURCV 




C2AF 


60 




364 




RTS 








C2B0 






365 


* 










C2B0 






366 


* 


HANDLE RESET FOR MONITOR: 




C2B0 






367 


* 










C2B0 




C2B0 


368 


B 


RESETX EQU 


* 






C2B0 


:A9 FF 




369 




LDA 


rf$FF 


; DESTROY MODE BYTE 




C2B2 


:8D FB 


04 


370 




STA 


MODE 






C2B5 


:AD 5D 


CO 


371 




LDA 


CLRAN2 


-SETUP 




C2B8 


:AD 5F 


en 


372 




LDA 


CLRAN3 


; ANNUNCIATORS 




C2BB 






373 


* 










C2BB 






374 


■k 


IF THE OPEN APPLE KEY 






C2BB 






375 


* 


(ALIAS PADDLE BUTTONS 0) IS 




C2BB 






376 


* 


DEPRESSED 


, COLDS TART 


THE SYSTEM 




C2BB 






377 


* 


AFTER DESTROYING MEMORY: 




C2BB 






378 


* 










C2BB 


:AD 62 


CO 


379 




LDA 


BUTN1 


;GET BUTTON 1 (SOLID) 





'•- 
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C2BE 
C2C0 
C2C3 
C2C6 
C2C8 
C2C8 
C2C8 
C2C8 
C2C8 
C2CA 
C2CC 
C2CE 
C2D0 
C2D1 
C2D1 
C2D3 
C204 
C2D6 
C2D8 
C2D9 
C2DB 
C2DC 
C2DE 
C2E0 
C2K2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E2 
C2E5 
C2E8 
C2EA 
C2ED 
C2EE 
C2EE 
C2F2 
C2F2 
C2F4 
C2F6 
C2F9 
C2FB 
C2FE 
C2FE 
C2FE 
C300 

S 
C300: 



03 C2C3 
00 C6 
61 CO 
1A C2E2 



BO 
00 
3C 
BF 



C2D1 



3 D 

AO 

3C 

3C 

01 
01 
EF 



C2D1 



C2E2 

OB CO 
89 CA 
03 C2ED 

OA CO 



88 95 8A 8R 



24 

28 

IF CO 

F2 C2EI1 

26 CE 

0002 
0002 
0000 



380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 



BPL NOD I AGS ;=>Up, no diags 

JMP DIAGS ;=>else go do diagnostics 

NOD I AGS LDA BUTNO ;GET BUTTON (OPEN) 

BPL RESETRET ;=>NOT JIVE OR DIAGS 

* 

* BLAST 2 BYTES OF EACH PAGE, 

* INCLUDING THE RESET VECTOR: 



LDY 
LDA 
STA 
LDA 
SEC 
BLAST EQU 
STA 
PHA 
LDA 
STA 
DEY 
STA 
PLA 
SBC 
CMP 
BNE 



#SBQ 
#0 
AIL 
£$BF 



A1H 

#SA0 
(A1L),Y 

(A1L),Y 

#1 

n 

BLAST 



;LET IT PRECESS DOWN 



; START FROM BFXX DOWN 
;FOR SUBTRACT 



;save ace to store 
;blanks 



;restore ace for counter 
;BACK DOWN TO NEXT PAGE 
;STAY AWAY FROM STACK! 



If there Is a ROM card plugged into slot 3, 
don't switch In the Internal ROM C3 space. 
only switch them In If there is a RAM card 
in the video slot. 



If not, 



NOTE: The //e powers up with internal $C3 ROM switched 
in. TSTROMCARD switches it out, RESETRET may or may 
not switch it back in. 



RESETRET EQU 
STA 
JSR 
BNE 
STA 

G0RETN1 RTS 

* 

ESC IN DFB 



SETSLOTC3ROM ;swap in slot 3 
TSTROMCRD ;ROM or no card plugged in? 
G0RETN1 ;=>ROM or no card, leave $C3 slot 
SETINTC3R0M ;card, enable internal ROM 



$88,$95,$8A,$8B 



B.RDK.EYX LDY CH 

LDA (BASL),Y 
BIT RD80VID 
BMI GORETN1 
JMP INVERT 



;get cursor position 

;and character 

;80 columns? 

;=>don't display cursor 

;else display cursor, exit 



ZSPAREC2 EQU C30RG-* 

DS C30RG-*,0 

IFNE *-C30RG 

FAIL 2,'C300 overflow' 

FIN 
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305 



C300 
C300 
C300 
C300 
C300 
C300 
C300 
C300 
C300 
C300 
C300 
C300 
C300 
C300 
C303 
C305 
C305 
C305 
C305 
C305 
C305 
C306 
C307 
C307 
C307 
C307 
C307 
C307 
C308 
C309 
C30B 
C30B 
C30B 
C30B 
C30B 
C30B 
C30B 
C30B 
C30B 
C30C 
C30D 
C30D 
C30E 
C30F 
C310 
C3U 
C311 
C311 
C311 
C311 
C314 
C317 
C317 
C317 



INCLUDE C3 SPACE 
**************************************** 



C300 
C300 

2C 43 CE 

70 12 C317 



C305 



18 

B8 
50 0C 



C317 



01 

88 

4A 
50 
56 
5C 



4C 76 C3 
AC C3 C3 



8D 7B 06 



THIS IS THE SC3XX ROM SPACE: 

Note: This page must not be used by any routines 
called by the F8 ROM. When it is referenced, it claims 
the C800 space (kicking out anyone who was using it). 



19 
1 

2 * 

3 * 

4 * 

5 * 

6 * 

7 * Thi9 also means that peripheral cards cannot use the AUXMOVE 

8 * and XFER routines from their C800 space. 

9 * 

10 **************************************** 

1 t CN00 equ * 

12 BASICINT EQU * 

13 BIT SEV ;set vflag (init) 

14 BVS BASICENT ;( ALWAYS TAKEN) 

15 * 

16 * BASIC input entry point. After a PR#3, this is the 

17 * address that is called to input each character. 

18 * 

19 BASIC IN EQU * 



20 
21 
22 
23 
24 
25 



SEC 
DF6 



$90 



;BCC OPCODE (NEVER TAKEN) 



BASIC output entry point. After a PR#3, this is 
address that is called to output each character. 



the 



C307 26 BASICOUT EQU * 



2 7 
28 
29 
30 
31 
32 
33 
34 



CLC 

CLV 
BVC 



;CLEAR VFLAG (NOT INIT) 
;( ALWAYS TAKEN) 



BASICENT 
Pascal 1.1 Firmware Protocol table 



This tables identifies this as an Apple //e 80 column 
card. It points to the four routines available to 

35 * programs doing I/O using the Pascal 1.1 Firmware 

36 * Protocol. 

37 * 
38 
39 
40 
41 
^2 
43 
44 
45 
46 
47 
48 
49 
50 



;GENERIC SIGNATURE BYTE 
;DEVICE SIGNATURE BYTE 

;PASCAL INIT 
; PASCAL READ 
; PASCAL WRITE 
; PASCAL STATUS 

**************************************** 

* 

* 128K SUPPORT ROUTINE ENTRIES: 



DFB 


$0i 


DFB 


$88 


DFB 


#>JPINTT 


DFB 


#>JPREAD 


DFB 


#>JPWRITE 


DFB 


#>JPSTAT 



JMP MOVE ; MEMORY MOVE ACROSS BANKS 
JMP XFER ; TRANSFER ACROSS BANKS 

51 **************************************** 

52 * 

53 BASICENT STA CHAR 



-< 
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C31A 
C31B 
C31C 
C3LD 
C3LE 
C31F! 
C31F: 
C31F: 
C3LF: 
C31F: 
C31F: 
C31F: 
C322; 
C325: 
C327: 
C329: 
C32C: 
C32C: 
C32C: 
C32F: 
C330: 
C332: 
C332: 
C332: 
C332: 
C332: 
C332: 
C334: 
C335: 
C337: 
C33A: 
C33B: 
C33C: 
C33D: 
C33E: 
C341: 
C344: 
C344: 
C347: 
C34A: 
C34A: 
C34A: 
C34D: 
C350: 
C350: 
C353: 
C356: 
C356: 
C359: 
C35C: 
C35C: 
C35D: 
C35F: 
C360: 



:98 
:48 
:8A 
:48 
:08 



AD FB 
2C F8 
30 05 
09 08 
8D FB 



20 6D 
28 
70 15 



90 10 
AA 

10 0D 
20 5B 
68 
AA 
68 
A8 

AD 78 
6C 38 

4C 7C 

4C 03 



20 6D 
4C B4 

20 6D 
4C D6 

20 6D 
4C FO 

AA 

FO 08 
CA 
DO 07 



04 
07 



C32C 



04 



C32C 



C3 



C347 



C344 
C344 



CD 



Q6 
00 

C8 
C8 



C34A 



C3 

C9 
C 

C3 
C9 



C350 



C356 



C3 

C9 



C367 
C369 



54 

55 
56 
57 
58 
59 

6 (J 
61 
62 
63 
64 
65 
66 
6? 
68 
69 
70 
71 
72 
73 
74 
75 

7 6 
77 
78 
79 
SO 
81 
82 
83 
84 
85 
86 
87 
88 
84 
90 

9! 

^2 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 



TYA 
PHA 

TXA 

PHA 
PHP 



AND Y 



AND X 



;SAVE CARRY & VFLAG 



If escape mode is allowed, the high bit of MSLOT is 
clear. Set M.CTL to flag that 1) escapes are allowed, and 
2) that control characters should not be echoed. 
M.CTL is cleared by BPRINT. 



;else esc enable, ctl disable 

;get MSLOT 

;=>Esc disable, ctl char enable 



LDA 


MODE 


BIT 


MSLOT 


BMI 


NOGETLN 


ORA 


#M.CTL 


STA 


MODE 



SETC8 



JBASINIT 



; SETUP C8 INDICATOR 
;GET VFLAG ( INIT) 
;=>DO THE INIT 



NOGETLN EQU 
JSR 

PLP 
BVS 

* 

* If a PR#0 has been done, input should be transferred 

* from the video firmware to KEYIN. This is detected 

* if the high bit of the mode byte is set. 



;=>output , no problem 
;test mode 

;video firmware is on 
;else set FD1B as input 
;restore registers 



BCC 


JC8 


TAX 




BPL 


JC8 


JSR 


SETK.EYIN 


PLA 




TAX 




PLA 




TAY 




LDA 


CHAR 


JMP 


(KSWL) 



JC8 JMP C8BASIC 
JBASINIT JMP BASICINIT 



;go input the character 

;GET OUT OF CN SPACE 
:=>GOTO C8 SPACE 



JPINIT EQU 
JSR 
JMP 

JPREAD EQU 
JSR 
JMP 

JPWRITE EQU 
JSR 
JMP 



JPSTAT 



TAX 
BEQ 
DEX 

BNE 



SETC8 
PINIT 

SETC8 
PREAD 

SETC8 
PWRITE 



PIORDY 



PSTERR 



; SETUP C8 INDICATOR 
;XFER TO PASCAL INIT 

; SETUP C8 INDICATOR 
;XFER TO PASCAL READ 

; SETUP C8 INDICATOR 
;XFER TO PASCAL WRITE 

;is request code = 0? 
;=>yes, ready for output 

;check for any input 
;=>bad request, return error 
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C362 


2C 


00 


CO 


108 






BIT 


KBD 


;look for a key 


C365 


to 


D4 


C36B 


109 






BPL 


PNOTRDY 


=>no keystroked 


C367 


38 






110 


PIORDY 


sec 






C368 


60 






111 






RTS 






C369 








112 


A 










0369 


A2 


03 




113 


PSTERR 


LDX 


#3 


.else flag error 


C36B 


18 






114 


PNOTRDY 


CLC 






C36C 


60 






115 






RTS 






C36D 








1L6 


*********************** ***************** 


C36D 








117 


* 


NAME 




SETC8 




C36D 








118 


A 


FUNCTION: 


SETUP IRQ SC800 PROTOCOL 


C36D 








119 


* 


INPUT 




NONE 




C36D 








120 


* 


OUTPUT : 


NONE 




C36D 








S ?! 


* 


VOLATILE: 


NOTHING 




C36D 








L22 


* 


CALLS 




NOTHING 




C36D 








123 


**************************************** 


C36D 








124 


* 










C36D 






C36D 


125 


SETC8 


KQU 


* 




C36D 


A2 


C3 




126 






LDX 


KCNOO 


SLOT NUMBER 


C36F 


8E 


F8 


07 


127 






STX 


MSLOT 


STUFF IT 


C372 


AE 


t'F 


C ? 


128 






LDX 


SCFFF 


kick, out other SC8 ROMs 


C375 


60 






129 






RTS 






C376 








130 


******** *************** j 


t*** ************* 


C376 








1 3 L 


A 


NAME 




MOVE 




C376 








132 


* 


FUNCTION: 


PERFORM CROS 


5SBANK MEMORY MOVE 


C376 








! J3 


* 


INPUT 




Al = SOURCE AI 


3DRESS 


C376 








134 


* 






A2=SOURCE EI 


TO 


C376 








135 


* 






A4=DESTINAr 


ION START 


C376 








136 


ft 






CARRY SET=MJ 


UN— >CARD 


C376 








137 


* 






CLR=CJ 


UID— ->MAIN 


C376 








138 


* 


OUTPUT : 


NONE 




C376 








139 


A 


VOLATILE: 


NOTHING 




C376 








140 


* 


CALLS 




NOTHING 




C376 








W 


***********************! 


***************** 


C37 6 








142 


* 










C376 






C376 


143 


MOVE 


EQU 


* 




C376 


48 






144 






PHA 




SAVE AC 


C377 


48 






145 






TYA 




AND Y 


C378 


48 






146 






PHA 






C379 


AD 


L3 


GO 


147 






LDA 


RDRAM RD 


SAVE STATE OF 


C37C 


48 






148 






PHA 




MEMORY FLAGS 


C37D 


AD 


u 


CO 


149 






LDA 


RDRAMWRT 




C380 


48 






150 






PHA 






C381 








151 


* 










C381 








152 


■k 


SET FLAGS 


FOR CROSSBAI 


«K MOVE: 


C381 








153 


* 










C381 


90 


08 


C38B 


154 






BCC 


M0VEC2M 


=>CARD— >MAIN 


C383 


8D 


02 


CO 


155 






STA 


RDMAINRAM 


SET FOR MAIN 


C386 


8D 


05 


CO 


L56 






STA 


WRCARDRAM 


TO CARD 


C389 


BO 


06 


C391 


157 






BCS 


MOVESTRT 


=>(ALWAYS TAKEN) 


C38B 








158 


* 










C38B 






C38B 


159 


M0VEC2M 


EQU 


* 




C38B 


8D 


04 


CO 


160 






STA 


WRMAINRAM 


SET FOR CARD 


C38E 


8D 


03 


CO 


161 






STA 


RDCARDRAM . 


TO MAIN 



:>.s 
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C39L: 








162 


* 










C391: 






C391 


163 


MOVESTRT EQU 


-k 




C391: 


AO 


00 




164 






LDY 


m 


; DUMMY INDEX 


C393: 








165 


* 










C393: 






C393 


166 


MOVELOOP EQU 


* 




C393: 


81 


3C 




167 






LDA 


(A1L),Y 


;GET A BYTE 


C395: 


9] 


-2 




168 






STA 


(A4L),Y 


;MOVE IT 


C397: 


B6 


42 




169 






INC 


A4L 




C399 : 


DO 


02 


C39D 


170 






BNE 


NXTA1 




C39B: 


E6 


i3 




171 






INC 


A4H 




C39D: 


h5 


3C 




172 


NXTA1 


LDA 


AIL 




C39F: 


C5 


3E 




173 






CMP 


A2L 




C3A1: 


A3 


3D 




174 






LDA 


AIR 




C3A3: 


H5 


3F 




175 






SBC 


A2H 




C3A5: 


E6 


3C 




176 






INC 


AIL 




C3A7: 


DO 


02 


C3AB 


177 






BNE 


C01 




C3A9: 


E6 


3D 




178 






INC 


ALH 




C3AB: 


90 


B« 


C393 


179 


C01 


BCC 


MOVELOOP 


;=>MORE TO MOVE 


C3AD: 








L80 


* 










C3AD: 








181 


■k 


RESTORE ORIGINAL FLAGS: 


C3AD: 








182 


* 










C3AD 


8i) 


34 


CO 


183 






STA 


WRMAINRAM 


; CLEAR FLAG 2 


C3B0: 


68 






184 






PLA 




;GET ORIGINAL STATE 


C3S1: 


10 


03 


C3B6 


185 






BPL 


C03 


;=>IT WAS OFF 


C3B3: 


80 


5 


CO 


186 






STA 


WRCARDRAM 




C3S6- 






C3B6 


187 


CO 3 


EQU 


* 




C3B6, 


8 


2 


CO 


188 






STA 


RDMAINRAM 


; CLEAR FLAG1 


C3B9 


68 






189 






PLA 




;GET ORIGINAL STATE 


C3BA- 


LO 


3 


C3BF 


190 






BPL 


MOVERET 


;=>IT WAS OFF 


C3BC 


8D 


03 


CO 


191 






STA 


RDCARDRAM 




C3BFI 






C3BF 


192 


MOV ERE! 


EQU 


* 




C3BF 


68 






193 






PLA 




; RESTORE Y 


C3C0: 


AS 






194 






TAY 






C3C1 


6P 






195 






PLA 




; AND AC 


C3C2 


60 






196 






RTS 






C3C3 








197 


**************************************** 


C3C3 








198 


* 


NAME 




XFER 




C3C3 








199 


* 


FUNCTION: 


TRANSFER CONTROL CROSSBANK 


C3C3 








200 


ft 


INPUT 


: 


?03ED=TRANSFER ADDR 


C3C3 








201 


* 






CARRY SET= 


KFER TO CARD 


C3C3 








202 


ft 






CLR= 


ICFER TO MAIN 


C3C3 








203 


* 






VFLAG CLR= 


USE STD ZP/STK 


C3C3 








204 


* 




: 


SET= 


USE ALT ZP/STK 


C3C3 








205 


* 


OUTPUT : 


NONE 




C3C3 








206 


* 


VOLATILE: 


$03ED/O3EE 


IN DEST BANK 


C3C3 








207 


* 


CALLS 


: 


NOTHING 




C3C3 








208 


* 


NOTE 


: 


ENTERED VIA JMP, NOT JSR 


C3C3 








209 


**************************************** 


C3C3 








210 


A 










C3C3 






C3C3 


211 


XFER 


EQU 


* 




C3C3 


48 






212 






PHA 




;SAVE AC ON CURRENT 


C3C4 








213 


* 










C3C4 








214 


* 


COPY 


DESTINATION ADDRESS TO THE 


C3C4 








215 


ft 


OTHER BANK SO THAT 


rfE HAVE IT 
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309 



C3C4 
C3C4 
C3C4 
C3C7 
C3C8 
C3CB 
C3CC 
C3CC 
C3CC 
C3CC 
C3CE 
C3D1 
C3D4 
C3D6 
C3D6 
C3D9 
C3DC 
C3DC 
C3DC 
C3DD 
C3E0 
C3E1 
C3E4 
C3E5 
C3E7 
C3EA 
C3EC 
C3EF 
C3F2 
C3F2 
C3F4 
C3F4 
C3F4 
C3F4 
C3F4 
C3F7 
C3FA 
C3FA 
C3FA 
C3FA 
C3FA 
C3FA 
C3FA 
C3FD 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 



AD ED 03 

48 

AD EE 03 

48 



90 08 
8D 03 CO 
8D 05 CO 
BO 06 

8D 02 CO 

8D 04 CO 



C3D6 



C3DC 
C3D6 



C3DC 



68 

8D EE 03 

68 

8D ED 03 

68 

70 05 

3D 08 CO 

50 03 

8D 09 CO 

6C ED 03 



C3EC 



C3EF 



0002 



8D 8L CO 
4C 7A FC 



2C 15 CO 
8D 07 CO 



C400 



n« 



216 
217 
218 
219 

220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
20 
1 
2 
3 
4 
5 
6 



* IN CASE WE DO A SWAP: 

* 

LDA S03ED 

PHA 

LDA S03EE 

PHA 



GET XFERADDR LO 
SAVE ON CURRENT STACK 
GET XFERADDR HI 
SAVE IT TOO 



* SWITCH TO APPROPRIATE BANK: 
* 

BCC XFERC2K ; = >CARD— >MAIN 

STA RDCARDRAM ; SET FOR RUNNING 

STA WRCARDRAM ; IN CARD RAM 

BCS XFERZP ;=> always taken 

XFERC2M EQU * 

STA RDMAINRAM ;SET FOR RUNNING 

STA WRMAINRAM ; IN MAIN RAM 



; SWITCH TO ALT ZP/STK 
; STUFF XFERADDR 
; HI AND 



XFERZP EQU * 

PLA 

STA $03EE 

PLA 

STA S0 3ED ; LO 

PLA ; RESTORE AC 

BVS XFERAZP ;=>switch in alternate zp 

STA SETSTDZP ;else force standard zp 

BVC JMPDEST ;=>always perform transfer 

XFERAZP STA SETALTZP jswitch in alternate zp 

JMPDEST JMP ($03ED) ;=>off we go 
* 

DS C30RG+$F4-*,0 ;pad to interrupt stuff 

* 

* This is where the interrupt routine returns to. 

* At this point the ROM is not necessarily switched in so... 
* 

IRQDONE STA 5C081 ;read ROM, write RAM 
JMP IRQD0NE2 ;and lump to ROM 

* 

* This is the main entry point for the interrupt 

* handler. This switches in the internal ROM and 

* lumps to the main part of the interrupt handler 

* at $C400. 

* 

irq hit rdexrom ;Test internal or external torn 

sta setintcxrom ;Force in ROM to get to interrupt handler 

* 

* Fall into SC400 which is now switched in!! 

* 

INCLUDE IRQ 

* 

* Here is the main interrupt handler 

•kft&'kisjck-k'kjfk-k'k kick ■k'kick'k'k'k Is icM-kick kbit %% -kbit -kbit 



newirq equ 
eld 



;make no assumptions!! 
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C401 


3fi 






,' 


sec 




C402 


30 


01 


C405 


8 


bmi 


irqintcx 


C404 


18 






9 


clc 




C405 


ia 






10 irqint 


ex pha 




C406 


~8 






11 


pha 




C407 


49 






12 


pha 




C408 


8A 






13 


txa 




C409 


BA 






14 


tSK 




C40A- 


E8 






15 


inx 




C40B 


E8 






16 


inx 




C40C 


E8 






17 


inx 




C40D 


E8 






18 


inx 




C40B 


48 






19 


pha 




C40F 


93 






20 


tya 




C410 


48 






21 


pha 




C411 


BD 


00 


01 


12 


Ida 


$100, x 


C414 


29 


10 




2:i 


and 


#$10 


C416 


A3 






24 


tay 




C417 








25 * Now 


test & 


set the st 


C417 


AD 


18 


CO 


26 


Ida 


rdSOcol 


C41A 


2D 


1C 


CO 


27 


and 


rdpage2 


C41D 


29 


80 




28 


and 


#$80 


C41F 


F0 


5 


C426 


29 


beq 


irq2 


C421 


A 9 


20 




30 


Ida 


#$20 


C423 


8D 


54 


CO 


31 


sta 


txt pagel 


C426 


2A 






32 irq2 


rol 


A 


C427 


2C 


13 


CO 


33 


bit 


rdramrd 


C42A 


10 


5 


C431 


34 


bpl 


irq3 


C42C 


3D 


2 


CO 


35 


sta 


rdmainram 


C42F 


9 


2'"' 




36 


ora 


#$20 


C431 


2C 


14 


CO 


37 irq3 


bit 


rdramwrt 


C434 


10 


5 


C43B 


38 


bpl 


irq4 


C436 


8D 


04 


CO 


34 


sta 


wrnainram 


C439 


09 


10 




40 


ora 


#$10 


G43B 






C43B 


41 irq4 


equ 


* 


C43B 


2C 


12 


CO 


42 irq5 


bit 


rdlcrara 


C43E 


10 


oc 


C44C 


43 


bpl 


irq7 


C440 


09 


nc 




46 


ora 


#$0C 


C442 


2C 


1 1 


CO 


45 


bit 


rdlcbnk2 


C445 


10 


02 


C449 


46 


bpl 


irq5 


C447 


49 


06 




47 


eor 


#$06 


C449 


8D 


81 


CO 


48 irq6 


sta 


romin 


C44C 


2C 


16 


CO 


49 irq7 


bit 


rdaltzp 


C44F 


.<'< 


OD 


C45E 


50 


bpl 


irq8 


C451 


BA 






51 


tsx 




C452 


BE 


01 


01 


52 


stx 


$101 


C455 


AE 


on 


01 


53 


ldx 


$100 


C458 


9A 






54 


txs 




C439 


8D 


08 


CO 


55 


sta 


setstdzp 


C45C 


09 


BO 




56 


ora 


#$80 


C45E 


:88 






57 irq8 


dey 




C45F 


.30 


OC 


C46D 


58 


bmi 


irq9 


C±61 


:5 


44 




59 


sta 


raacstat 


C463 


:: 






60 


pla 





;C=1 if internal slot space 



;Save A on stack instead of $45 
;Make room for rts if needed 

;Save X 

;Get stack pointer for BRK bit 

; Can't do add cause we need C 



;and Y 

;Get status for break test 
;A = $10 if break 

;Save it for later 
ate of the machine. Don't alter 1 
;Test for 80 store and page 2 

;Make it or $80 

;Branch if no change needed 

;Set shifted page 2 reset bit 

;Set page 1 

;Align bit & shift in slotcx bit 

;Are we reading from aux ram? 

; Branch if main ram read 

;ElBe, switch main in 

;and record the event 

;Do the same for ram write 



;Deterrnine if language card active 

;Sets two bits. Second is redundant 
;if INC used to restore. 
;Branch if not page 2 of $0000 
;Set bits for page 2 

;Enable ROM STA leaves write enable alone 
; Last... and very important 
;lf alternate stack 
;store current stack pointer at $101 

jRetreve main stack pointer from $100 



;Mark stack switched 
;Was it a break? 

;Save state of machine 
jRestore registers 
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C464 
C465 
C466 
C467 
C468 
C469 
66 
C46A 
C46D 
C46E 
C471 
C472 
C474 
C475 
C477 
C478 
C479 
C47C 
C47C 
C47C 
C47C 
C47C 
C47C 
C47C 
C47C 
C47C 
C47C 
C47F 
C480 
C482 
C485 
C488 
C489 
C48B 
C48D 
C490 
C493 
C494 
C496 
C497 
C499 
C49A 
C49B 
C49C 
C49D 
C49E 
C4A0 
C4A1 
C4A3 
C4A4 
C4A6 
C4A8 
C4A9 
C4AB 



:A8 
:68 
:AA 
:68 
;68 
:68 

4C 47 FA 

48 

AD F8 07 

48 

A9 C3 

48 

A9 F4 

48 

08 

4G 7 4 FC 



pla 



AD 81 CO 

68 

10 07 

8D 09 CO 

AE 01 01 

9A 

AO 06 

10 06 

BE CI C4 

FE 00 CO 

88 

30 03 

OA 

DO F2 

OA 

OA 

68 

AS 

BA 

A9 40 

48 

A9 CO 

48 

A9 06 

69 00 

48 

A9 8D 

48 



C489 



C493 



C499 



C48B 



8 * 



61 
62 
63 
U 
65 



67 

68 

69 
70 
7] 

72 
7 3 
7 4 
73 
7fi 
77 
7 

7 9 
80 

8 I 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
9* 
99 

100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 



tay 
pla 
tax 
pla 
pla 



;A stored where RTS address would go 



jmp newbreak 
lrq9 pha 

Ida mslot 

pha 

Ida 

pha 

Ida #>lrqdone ;so when Interrupt does RTI 

pha 

php 

.imp 
* The user's 
BEWARE 
The roni tnust be reenabled with a LDA romin 
This way if the LC was write protected, it still is 
if it was write enabled, it still is 

it was being write enabled ( 2 Idas), it still will be 
restore loop uses an INC because some of the switches are read 
some are write. It must be an INC abs.x since both the 6502 und 
65C02 do two reads before the write. 



;Go to normal break routine stuff 

; Save state of machine on stack 
;Save mslot 



/Kirqdone ;Save return irq address 

#>irqdone ;so when interrupt does 
;It returns to Irqdone 
;Status for user's RTI 

irquser ;Off to the user 

RTI returns here 



* if 

* The 

* and 

* the 
irq fix 



irqdnl 
irqdn2 



irqdn3 



irqdn4 



Ida 
pla 
bpl 
sta 
ldx 
txs 
ldy 
bpl 
ldx 
inc 
dey 
bmi 
asl 
bne 
asl 
asl 
pla 
tay 
tsx 
Ida 
pha 
Ida 
pha 
Ida 
adc 
pha 
Ida 
pha 



;Must be Ida! 

;Recover machine state 
; Branch if main ZP 

;Get alt stack pointer 

;Y = index into table of 

;Branch if no change 
irqtble,y ;Get soft switch address 
$C000,x ;Hit the switch. NO PAGE CROSS! 



romin 

irqdnl 

setaltzp 

$101 

#$06 
i rqdn3 



switch addresses 



Irqdn4 

A 
Irqdn2 

A 

A 



;Get next bit to check 
;C = 1 If internal slot 
;Restore the registers 



space 



; Save the stack pointer 
;RTI opcode 



#S40 

#<setslotcxrom 

#>setslotcxrom 

#0 ;Add 1 if internal slot space 



iC$8D 



;STA setslotcxrom 



:■:. 
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C4AC:9A 






114 


txs 




C4AD:8A 






115 


txa 




C4AE:69 


03 




116 


adc 


to 


C4B0:AA 






117 


tax 




C4BH38 






118 


sec 




C4B2:E9 


07 




119 


sbc 


in 


C4B4:9D 


00 


01 


120 


sta 


$100, x 


C4B7:E8 






121 


inx 




C4B8 : A9 


0J 




122 


Ida 


#$1 


C4BA:9D 


00 


01 


123 


sta 


$100 ,x 


C4BD:68 






124 


pla 




C4BE:AA 






125 


tax 




C4BF:68 






126 


pla 




C4C0:60 






127 


rts 





;Restore stack pointer 

;Make return address on stack point to code on stack 
;C = from earlier adc 



;Point to where code starts 



;Go to code on stack 



C4C1 
C4C4 
C4C7: 

C60Q 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 
C600 



83 8B 8B 
05 03 55 

■ NEXT OBJECT 
C600 



C051 
0009 
0001 
05 B8 
COOO 

C600 



129 

130 

21 

FILE 

1 

2 

3 

4 

5 
6 
7 

a 

9 

1 

11 

12 

13 
14 
15 
16 
17 
18 
19 
20 
21 
22 

2 3 
24 
25 
26 
27 
28 
29 
30 
31 

3 2 
3 3 



irqtble dfb >lebank2 ,>lcbankl ,>lcbankl 

df b >wrcardram ,>rdcardram ,>txtpage2 

INCLUDE DIAGS 
NAME IS REFLIST.l 

ORG C30RG+S300 

* These routines test all 64K RAM, as well as the 64K on an Auxiliary 

* memory card (when present). With the exception of the INTCXROM switch 

* of the I0U, all combinations of the IOU switches are tested and ver- 

* if led. All configurations of the MMU switches are also tested. 
* 

* In the event of any failure, the diagnostic Is halted. A message 

* is written to screen memory Indicating the source of the failure. 

* When RAM fails the message is composed of "RAM ZP" (indicating failure 

* detected in the first page of RAM) or "RAM" (meaning the other 63.75K), 

* followed by a binary representation of the failing bits set to "1". 

* For example, "RAM 1 10 0" indicates that bits 5 and 6 were 

* detected as falling. To represent auxiliary memory, a "*" symbol is 

* printed preceeding the message. 

* When the MMU or I0U fail, the message is simply "MMU" or "IOU". 

* The test will run continuously for as long as the Open and Closed 

* Apple keys remain depressed (or no keyboard is connected) and no 

* failures are encountered. The message "System OK" will appear in 

* the middle of the screen when a successful cycle has been run and 

* either of the Apple keys are no longer depressed. Another cycle 

* may be initiated by pressing both Apple keys again while this message 

* is on the screen. To exit diagnostics, Control-Reset must be pressed 

* without the Apple keys depressed. 



TEXT 

IOUIDX 

MMUIDX 

SCREEN 

IOSPACE equ 

* 

DIAGS equ 



equ 
equ 
equ 
equ 



$C051 

$09 

$01 

$5B8 

$C000 
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C600 
C603 
C603 
C603 
C603 



8D 50 CO 34 sta SC050 

35 * Test Zero-Page, then all of memory. Report errors when encountered. 

36 * Accumulator can be anything on entry. All registers used, but no stack. 

37 * Addresses between $C000 and $CFFF are mapped to main $D000 bank. 

38 * Auxiliary 64K is also tested if present. 



C603 
C605 
C607 
C608 
C60B 
C60D 
C&OE 
C610 
C611 
C614 
C616 
C618 
C619 
C61B 
C61C 
C61F 
C621 
C623 
C624 
C626 



A0 04 
A2 00 
18 

79 B4 C7 
95 00 
E8 

;D0 F7 
18 

;79 B4 C7 
D5 00 
DO 10 
E8 

: DO F5 
6A 

2C 19 CO 
:10 02 
;49 A5 
88 

:10 El 
:30 06 



C607 



C628 



C610 



C623 



C607 
C62E 



40 TSTZPG 

41 

42 zpl 

43 

44 

45 

46 

47 zp2 

48 

49 

50 

51 

52 

5:3 

34 

5 5 

56 

57 zp3 

58 

39 



ldy 
ldx 
clc 
adc 
sta 
inx 
bne 
clc 
adc 
cmp 
bne 
inx 
bne 
ror 
bit 
bpl 
eor 
dey 
bpl 
bmi 



#$4 
#0 

ntbl,y 
$00, x 

Zpl 

ntbl ,y 
$00 ,x 

ZPE R.ROR 

zp2 

a 

RDVBLBAR 

zp3 

#$A5 

zpl 

TSTMEM 



;fill zero page with a pattern 



;after all bytes filled, 

; ACC has original value again. 

;so values can be tested 

jbranch if memory failed 

;loop until all 256 bytes tested 

; change ACC so location $FF will change 

; use RDVBLBAR for a little randomness.. 



;use a different pattern now 

; branch to retest with other value 

; branch always 



C628: 
C62A: 
C62B: 
C62E: 
C62E: 
C630: 
C632: 
C&34: 
C636: 
C638: 
C63A: 
C63B: 
C63E: 
C641: 
C643: 
C645: 
C647: 
C649: 
C64C: 
C64F: 
C651: 
C653r 
C655: 
C657: 
C659: 
C65A: 



55 00 

18 

4C CD C6 

86 01 
86 02 
86 03 
A2 04 
86 04 
E6 01 
A8 

8D 83 CO 
8D 83 CO 
A5 01 
29 F0 
C9 CO 
DO 0C 
AD 8B CO 
AD 8B CO 
A5 01 
69 OF 
DO 02 
A5 01 
85 03 
98 
A0 00 



C62E 



C655 



C657 



61 ZPERROR 

62 

63 

64 TSTMEM 

65 

66 

67 

bS 

69 

70 meml 

7 1 mem2 
72 

73 
74 
75 
76 
77 
78 
79 
80 
81 
82 

83 mem3 

84 mem4 
85 

86 



eor 
clc 
jrap 
equ 
stx 
stx 
stx 
ldx 
stx 
inc 
tay 
sta 
sta 
Ida 
and 
cmp 
bne 
Ida 
Ida 
Ida 
adc 
bne 
Ida 
sta 
tya 
ldy 



$00, x 

BADBITS 

* 

$01 

$02 

$03 

#4 

$04 

$01 

$C083 

$C083 

$01 

#$F0 

#$C0 

mem 3 

$C08B 

$C08B 

$01 

m 

mem4 

$01 

$03 

#$00 



;which bits are bad? 
jindicate zero page failure 



;do RAM $100-$FFFF five times 

; point to page 1 first 
;save ACC in Y for now 
anticipate not $CO0O range.., 

;get page address 

;test for $C0-$CF range 

;branch if not . . . 

; select primary ?D000 space 

;Plus carry =+$10 
; branch always taken 



;restore pattern to ACC 

;fill this page with the pattern 
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C65C 


13 






87 


mentS 


clc 




C65D:7P 


84 


C7 


8ft 




adc 


ntbl.x 


C660:91 


02 




,89 




sta 


($02), y 


C662:CA 






90 




dex 




C663:10 


2 


C667 


91 




bpl 


memfi 


C66 5:A2 


04 




92 




ldx 


#4 


C667:C8 






93 


raera6 


tny 




C668:D0 


F2 


C65C 


9k 




bne 


inemS 


C66A:E6 


01 




95 




inc 


1 


C66C:D0 


cc 


C63A 


96 




bne 


mem2 


C66E:E6 


01 




v8 




lnc 


$01 


C670 


a a 






99 


raem7 


t ay- 




C671 


:AD 


83 


CO 


100 




Ida 


$C083 


C674 


AD 


83 


CO 


101 




Ida 


$C083 


C677 


A5 


01 




102 




Ida 


$01 


C679 


29 


FO 




103 




and 


#$F0 


C67B 


C9 


CO 




104 




cmp 


#$co 


C67D 


DO 


09 


C688 


105 




bne 


mem8 


C67F 


Ah 


83 


CO 


106 




Ida 


5C08B 


C682 


45 


ill 




107 




Ida 


$01 


C684 


69 


OF 




108 




adc 


#$* 


C686 


DO 


02 


C68A 


109 




bne 


raera9 


C688 


A3 


01 




110 


mem8 


Ida 


$01 


C68A 


8 5 


3 




111 


mem9 


sta 


$03 


C68C 


98 






112 




tya 




C68D 


AO 


00 




113 




ldy 


#$00 


C68F 


18 






114 


meraA 


clc 




C690 


7i) 


B4 


07 


115 




adc 


ntbl ,x 


C693 


51 


02 




116 




eor 


($02), y 


C695 


DO 


35 


C6CC 


117 




bne 


MEMERROR 


C697 


SI 


2 




118 




Ida 


C$02),y 


C699 


CA 






119 




dex 




C69A 


10 


02 


C69E 


120 




bpl 


memB 


C69C 


A2 


04 




121 




ldx 


#4 


C69E 


ca 






122 


memB 


iny 




C69F 


Di i 


EE 


C68F 


123 




bne 


memA 


C6A1 


E6 


01 




124 




inc 


1 


C6A3 


DO 


CI 


C670 


125 




bne 


mem7 


C6A5 


6 A 






126 




ror 


a 


C6A6 


2C 


19 


CO 


127 




bit 


RDVBLBAR 


C6A9 


10 


2 


C6AD 


128 




bpl 


memC 


C6AB 


49 


A 5 




129 




eor 


#$A5 


C6AD 


C6 


04 




130 


memC 


dec 


$04 


C6AF 


10 


87 


C638 


131 




bpl 


meml 


C6B1 :AA 






133 




TAX 




C6B2:20 


6D 


C9 


134 




JSR 


STAUX 


C635:D0 


07 


C6BE 


135 




BNE 


SWCHTST1 


;6B7:0E 


00 


OC 


136 




ASL 


$C00 


2-:3A:0A 






137 




ASL 


A 


C6BB- 


:: 


00 


OC 


138 




CMP 


$C00 



;keep x In the range 0-4 



;all 256 filled yet? 

; branch if not 

;bump page if 

;loop through $0100 to $FF00 



;point to page 1 again 
;save ACC in Y for now 
;anticipate not $C000 range. 

;get page address 
;test for $C0-$CF range 

; branch if not... 

;select primary $D000 space 

;Plus carry =+$10 
; branch always taken 



;restore pattern to ACC 

j fill this page with the pattern 



;if any bits are different, give up!!! 
;restore correct pattern 
;keep x in the range 0-4 



;all 256 filled yet? 

; branch if not 

; bump page # 

;loop through $0100 to $FF00 

; change ACC for next pass 

: use RDVBLBAR for a little randomness. 



;have 5 passes been done yet? 
; branch if not . . . 



;save ace 

;set aux memory 4 write $EE to $COO,$800 

;=>not 128K 

;shift test byte 

; check memory 
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C6BE 
C6C0 
C6C3 
C6C5 
C6C6 
C6C9 
C6CC 
C6CD 
C6CE 
C6D1 
C6D2 
C6D4 
C6D7 
C6D9 
C6DB 
C6DE 
C6E1 
C6E2 
C6E3 
C6E5 
C6E8 
C6EB 
C6EE 
C6F1 
C6F4 
C6F7 
C6F8 
C6FA 
C6FB 
C6FD 
C6FF 
C701 
C703 
C705 
C707 
C70A 
C70D 
C710 
C711 
C713 
C715 
C7 L6 
C717 
C718 
C71A 
C71B 
C71E 
C71F 
C720 
C722 
C724 
C726 
C729 
C72B 



DO 76 C736 
CD 00 08 



FO 71 

8A 

8D 09 CO 

4C 03 C6 

38 

AA 

AD 13 CO 

B8 

10 03 

2C B4 C7 

A9 AO 

AO 06 

99 FE BF 

99 06 CO 

88 

88 

DO F6 

8D 51 

8D 54 CO 

99 00 04 

99 00 05 

99 00 06 

99 00 07 

C8 

DO Fl 

8A 

FO 2 7 

AO 03 

BO 02 



C736 



C6D7 



C6DB 



CO 



C6EB 



C724 



C703 



AO 05 

A9 AA 

50 03 

8D BO 05 

B9 EA C7 

99 Bl 05 

88 

10 F7 

AO 10 

8A 

4 A 

AA 

A9 58 

2A 

99 B6 05 



C70A 



C70A 



DO F3 
FO FE 
AO 02 
B9 FO C7 
90 03 
B9 F3 C7 



C715 
C722 



C72E 



139 SWCHTST1 BNE 

140 CMP 

141 BEQ 

142 txa 

143 STA 

144 jmp 

145 MEMERROR sec 

146 BADB1TS tax 
147 
148 
149 
150 

151 bbitsl 
152 
153 clrsts 



154 

155 

156 

157 

158 

159 

160 clrs 

161 

162 

163 

164 

165 

166 

167 

168 

169 

170 



Ida 
civ 
bpl 
bit 
Ida 
ldy 
sta 
sta 
dey 
dey 
bne 
sta 
sta 
sta 
sta 
sta 
sta 
irty 
bne 
txa 
beq 
ldy 
bcs 
ldy 



171 badmain Ida 



172 
173 



bvc 
sta 



174 badprim Ida 

175 sta 

176 dey 

177 bpl 

178 ldy 

179 bblts2 txa 

180 lsr 

181 tax 

182 Ida 

183 rol 

184 sta 

185 dey 

186 dey 

187 bne 

188 hangx beq 

189 BADSWTCH ldy 

190 bswtchl Ida 

191 bcc 

192 Ida 



SWCHTST 

$800 

SWCHTST 

SETALTZP 
TSTZPG 



RDRAMRD 

bbitsl 
setv 

#$A0 

its 

IOSPACE-2,y 
I0SPACE+6,y 



->not 128K 

look for shadowing 

= >not 128K 

swap in alt zero page 

and test it! 
indicate main ram failure 
save bit pattern in x for now 
determine if primary or auxiliary RAM 
with V-FLG 
branch if primary bank 

try to clear video screen 






clrsts 
TEXT 
TXTPAGE1 
$400, y 
$500, y 
$600, y 
$700, y 

clrs 

;tesc for switch teat failure 
BADSWTCH ;branch if it was a switch 
(13 

badmain jbranch if ZP ok 
#5 

//$AA ;mark aux report with an asterisks 
badprim 
screen-8 
rraess ,y 
screen-7 ,y 

badprim ;message is either "RAM" or "RAM ZP" 
#$10 ;print bits 



#$58 

a 

screen-2,y 



;bits are printed as ascli or 1 



bbits2 
hangx 
#2 

smess ,y 
bswtch2 



;hang forever and ever 



; branch if MMU in error 



smess+3,y ;else indicate I0U error 



: : •: 
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C72E:99 B8 05 
0731:88 

C732:10 F2 C726 
C734:30 FE C734 



193 bswtch2 sta 

194 dey 

195 bpl 

196 hangy bmi 



screen ,y 

bswtchl 
hangy 



;print "MMU" or "IOU" 
;branch forever 



C736' 
C738: 
C73A: 
C73B; 
C73E: 
C740: 
C742: 
C745: 
C748: 
C749: 
C74B: 
C74B: 
C74E: 
C74F: 
C7 50: 
C753: 
C755: 
C757: 
C758: 
C7 5A: 
C75D: 
C75F: 
C761: 
C764; 
C766: 
C768: 
C768: 
C769: 
C76A: 
C76B: 
C76D: 
C7 6F: 
C770: 
C772: 
C774: 
C776: 
C776: 
C778: 
C77A: 
C77D: 
C77F: 
C781: 
C783; 
C785: 
C788: 
C78B: 
C7 8E: 
C791: 



A0 01 

A9 7F 

6A 

BE B9 C7 

FO OF 

90 03 

BE G9 C7 

9D FF BF 

C8 

DO EF 



C74F 
C745 



C73A 



AE 30 CO 

2A 

88 

BE D9 C7 

FO 13 C768 



C74B 



30 F4 

2A 

90 07 C76L 

IE 00 CO 

90 17 C776 

RO EE C74F 

IE 00 CO 

BO 10 C776 

90 E7 C74F 

2 A 

C8 

38 

E9 01 

BO CB C7 3A 

88 

DO OB C77D 

AO 09 

DO C2 C738 

A2 00 
CO OA 



C6 



4C D7 
46 80 
DO B5 
A9 AO 
AO 00 
99 00 04 
99 00 05 
99 00 06 
99 00 07 
C8 



C7 36 



198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 



SWCHTST 

SWtSt 1 

swt st2 



swtst3 

click 

swtst4 



swtst5 



swtst6 



BIGLOOP 

blp2 

blp3 



ldy 
Ida 

ror 
ldx 
beq 
bcc 
ldx 
sta 
iny 
bne 

ldx 
rol 
dey 
ldx 
beq 
bmi 
rol 
bcc 
asl 
bcc 
bcs 
asl 
bcs 
bcc 

rol 
iny 
sec 
sbc 
bcs 
dey 
bne 
ldy 
bne 

ldx 
cpy 
imp 
lsr 
bne 
Ida 
ldy 
sta 
sta 
sta 
sta 
iny 



^MMUIDX 
#|7F 

a ;set switches of the IOU/MMU to match Accumulator 

SWTBLO.y 

swtst4 ;branch if done setting switches 

swtst3 ;branch if setting switch to 0-state 

SWTBL1 ,y ;else get index to set switch to 1 

IOSPACE-L.x ;set switch 

swtst2 ;branch always taken... 

$C030 



RSWTBL.y 

swtst6 

click 

a 

swtst5 

IOSPACE.x 

swerr 

swtst4 

IOSPACE.x 

swerr 

swtst4 



#1 

swtst2 

BIGLOOP 
#IOUIDX 
swtst 1 

#0 

#IOUIDX+l 

bbitsl 

$80 

SWCHTST 

#$A0 

#0 

$400, y 

$500, y 

$600, y 

$700 ,y 



;now verify the settings just made 

;branch if done this pass 

jbranch if this switch no to be verified. 



; branch always 



jbranch always 

jrestore original value 
; and IOU/ MMU index 

;try next pattern 

;was MMU just tested? 
jbranch if IOU was just tested 
;else, go test IOU. 
jbranch always taken... 

; indicate switch error 
;set carry if IOU was cause 



; clear screen for success message 
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C792; 
C794: 
C797: 

C79A: 
C79B; 
C79D: 
C79F: 
C7A1: 
C7A4: 
C7A4i 
C7A7: 
C7A9: 
C7AC! 
C7AF; 
C7B0: 
C7B2; 
C7B4: 
C7B4: 
C7B4: 
C7B9: 
C7C9; 
C7D9 
C7EA: 
C7EA 
C7F0; 



DO Fl 

AD 61 
2D 62 
OA 

E6 FF 
A5 FF 
90 03 
4C 00 

AD 51 

AO 08 

B9 F6 

99 B8 
88 

10 F7 

30 EO 



53 43 
00 89 
00 81 
00 11 



D2 CI 
CD CD 



C785 



CO 
CO 



C7A4 
C6 

CO 

C7 

05 

C7A9 
C794 

C7B4 
2B 29 
31 03 
31 04 
FF 13 

CD AO 

D5 C9 



246 

247 blp4 

248 

249 

250 

251 

252 

253 

254 * 

255 dquit 
256 

257 suc2 

258 

259 

260 

261 

262 * 

263 setv 

264 ntbl 

265 swtblO 

266 swtbll 

267 rswtbl 
268 

269 rmess 

270 smess 



bne blp3 

LDA $C061 

AND $C062 

asl a 

INC $FF 

LDA $FF 

bcc dquit 

jmp DIAGS 



Ida 
ldy 
Ida 
sta 
dey 
bpl 
bmi 



TEXT 
#8 

success, y 
SCREEN ,y 

suc2 
blp4 



test for both Open and Closed Apple 

pressed 
put result in carry 



;put success message on the screen 



;loop forever 



equ * 

dfb 83,67,43,41,7 

dfb $00, $89, $31, $03, $05, $0 9 ,$0b, $01, $00, $83, $51 ,$53, $55, $57, $0F, $0D 

dfb $00, $81, $31, $04, $06, $OA,$0C, $02, $00, $84, $52, $54, $56, $58, $10, $0E 

dfb $00,$11,$FF,$13,$14,$16,$17,$I8,$00,$12,$1A,$1B,$1C,$1»,$1E, $1F,$00 

MSB ON 

asc "RAM ZP" 

asc "MMUIOU" 



C7F6 
C7FF 
C7FF 
C7FF 
C800 
C800 
C800 
C800 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C803 
C806 
C809 



D3 F9 F3 F4 
C7FF 

0001 



4C BO C9 



C803 



20 F4 CE 
20 2A C8 
20 2E CD 



272 

273 

22 

1 

2 
3 
k 

5 
6 

7 
8 

9 
10 
11 

12 
13 
14 

15 

16 
17 
18 
19 
20 
21 
22 
23 
24 



success asc "System OK" 
zzzend equ * 

INCLUDE C8 SPACE 

DS C8OUG-*,0 ipad to C800 
* 

* This entry point is only used by Pascal 1.0 

JMP PINIT1.0 ; PASCAL 1.0 I NIT 

* 

* BASIC initialization: 

* This is called by the $C3 space only after a PR#3 or 

* the equivalent (a JSR $C300). 
* 

* It causes a copy of the $F8 ROM to be placed in the 

* language card if the language card is switched in and 

* the ID byte doesn't match. It sets up all the 

* screenhole variables to support its operation. If the 

* 80 column card is detected, it sets things up for 80 column 

* operation, else 40 column, operation. Then it clears the 

* screen and prints the character that was in the accumulator 

* upon entry. 



BASIC IN IT EQU * 

JSR C0PYR0H 
JSR C3H00KS 
JSR DO40 



;If LC in, copy F8 to it 
;out=$C307, in=$C305 
;set full 40-col window 
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C80C 
C80E 
C811 
C811 
C811 
Co 11 
C814 
C816 
C818 
C81B 
C81E 
C81E 
C81E 
C81E 
C81E 
C821 
C824 
C827 
C82A 
C82A 
C82C 
C82E 
C830 
C832 
C832 
C832 
C832 
C834 
C836 
C838 
C83A 
C83B 
C83B 
C83D 
C83F 
C841 
C844 
C846 
C849 
C84A 
C84A 
C84A 
C84A 
C84A 
C84A 
C84D 

S 
C84D 
C84D 
C850 
C850 
C850 
C850 
C850 



A9 01 
8D FB 04 



20 90 CA 
DO 08 C81E 
06 21 
8D 01 CO 
8D OD CO 



C81E 



8D OF CO 
20 90 CC 
AC 7B 05 
4C 7E C8 

A9 07 
85 36 
A9 C3 
85 37 



A9 05 
85 38 
A9 C3 
85 39 

60 

E6 4E 

130 02 

E6 4F 

AD 00 CO 

10 F5 C83B 

8D 10 CO 

60 



C841 



0003 
0000 



4C 50 C3 



25 
26 

27 * 

28 * IS THERE A CARD? 

29 * 
30 
31 
32 
33 
34 
35 
36 

37 * 

38 CLEARIT EQU 



LDA 
STA 



JSR 
BNE 
ASL 
STA 

STA 



#M. MOUSE 
MODE 



TESTCARD 

CLEARIT 

WNDWDTH 

SET80C0L 

SET80VID 



;init with mouse text off 
;Set BASIC video mode 



SEE IF CARD PLUGGED IN 
=>IT'S 40 
SET 80-COL WINDOW 
ENABLE 80 STORE 
AND 80 VIDEO 



HOME & CLEAR: 



STA 
JSR 
LDY 

JMP 



39 

40 
41 

42 

43 * 

44 C3 HOOKS LDA 
STA 
LDA 
STA 



45 
46 

47 
48 

49 

50 * 

51 C3IN 
52 

53 
3 4 
55 

56 * 

57 GETKEY 



SETALTCHAR ;SET NORM/INV LCASE 
X.FF ;CLEAR IT 
OORCH ;set up cursor for store 
SPRINT ;always print a character 

#>BASICOUT ;set output hook first 

CSWL 

//<CN0O 

CSWH 



62 

63 
64 
65 
66 

67 
68 

69 
7 m 
71 
72 

73 

7 4 
75 

76 
77 
78 



C3IN is called by IN#0 if CSWH = #$C3 
;set input hook 



LDA 
STA 
LDA 
STA 
RTS 



//> BASIC IN 
KSWL 

//<CN00 
KSWH 



58 

59 



INC 
BNE 
INC 

60 GETK2 LDA 
BPL 
STA 
RTS 



RNDL 

GETK2 

RNDH 

KBD 

GETKEY 

KBDSTRB 



;exit with A=SC3 for IN#0 stuff 
;BUMP RANDOM SEED 



;KEYPRESS? 
;=>NOPE 
[CLEAR STROBE 



**************************************** 
* 

* PASCAL 1.0 INPUT HOOK: 

* 

DS C80RG+$4D-* ,0 ;pad to 1.0 books 
IFNE *-C80RG-$4D ;ERR IF WRONG ADDR 
FAIL 2/C84D HOOK ALIGNMENT' 
FIN 

JMP JPREAD ;=>GO TO STANDARD READ 

**************************************** 
* 

* CSETUP compensates for everything that the user 

* can do to change the cursor status: poke CV, CH, 

* OURCH, WNDWDTH. It updates the video firmware's 
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C850 
C850 
C850 
C850 
C850 
C852 
C855 
C857 
C85A 
C85C 
C85F 
C861 
C862 
C865 
C867 
C869 
C86C 
C86F 
C870 
C870 
C870 
C870 
C870 
C870 
C870 
C870 
C870 
C870 
C870 
C870 
C870 
C872 
C873 
C874 
C874 
C875 
C878 
C879 
C87A 
C87B 
C87C 
C87C 
0000 
C87R 
C87E 
C87E 
C87E 
C87E 
C87E 
C87E 
C87E 
C881 
C884 
C886 



A5 25 

8D FB 05 

A4 24 

CC 7B 04 

F0 03 C85F 

8C 7B 05 

A5 2L 

18 

ED 7 

BO 05 



B 05 



C86C 



AO 00 
8C 7B 05 
AC 7B 05 
60 



A4 35 
18 

BO FE 

38 

8D 7B 06 

98 

48 

8 A 
48 

BO 5E 



C873 
C874 



C87C 
C8DC 
0000 



20 50 C8 
AD 7B 06 
C9 8D 
DO 18 C8A0 



79 
8C 

81 

82 * 

83 CSETUF IDA 
STA 



* versions of these values for its own use. 

* COPY USER'S CURSOR IF IT DIFFERS FROM 

* WHAT WE LAST PUT THERE: 




84 

83 

8h 

87 

88 

89 CS2 

90 

91 

92 

93 

94 

95 CS3 

96 

97 * 

98 

99 
100 
101 
102 
103 
104 
105 
106 



LDY 
CPY 
BEQ 
STY 
LDA 
CLC 
SBC 
BCS 
LDY 
STY 
LDY 
RTS 



CV 

OURCV 

CH 

OLDCH 

CS2 

OURCH 

WNDWDTH 

OURCH 

CS3 

#0 

OURCH 

OURCH 



;set up OURCV 

;GET IT 

;IS IT THE SAME? 

;=>YES, USE OUR OWN 

;update our cursor 

;cursor horizontal must not 

;be greater than window width 

;lf It is, then put cursor 

;at left edge of window 



;exlt with Y 



CH 



BIN and BOUT are used when characters are 

input and output by the $F8 ROM while 80VID 

is on. They cannot use the $C3 entry points 

because that switches In the $C8 space, causing 

possible conflict with other $C8 users. 

These routines are only called by the $Ci00-SC2FF space. 



These entry points will only work if the card was 
first initialized using a PR#3. 80 columns will not 

107 * work simply by turning on the 80V1D flag. 

108 * 
SAVYl ;load Y stuffed by SF8 ROM 

;signal an output 
* jskip SEC 



109 BOUT 

110 

111 

112 

113 BIN 

114 

115 

116 

117 

118 



LDY. 
CLC 
BCS 
ORG 
SEC 
STA 
TYA 
PHA 
TXA 
PHA 



*-l 



CHAR 



119 C8BASIC EQU * 



120 
1 

2 3 
24 
1 
2 
3 
4 
5 
6 
7 



TEST 



BCS 
EQU 
LST 



BINPUT 


ON.A.V 



;signal an input 
jsave the char 
;save Y 

; s ave X 

; BASIC IN/ OUT 
;=>input a character 
;REAL VERSION 



INCLUDE BPRINT 



This is the place where characters printed using the 
CSW hook are actually printed (or executed it they are 
control characters). 



BPRINT 



JSR 


CSETUP 


setup user cursor 


LDA 


CHAR 


GET CHARACTER 


CMP 


#$8D 


,IS IT C/R? 


BNE 


N0WAIT 


=>don't wait, OURCH ok 



yy. 
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C888 
C88B 
C88D 
C88F 
C891 
C894 
C897 
C899 
C89B 
C89D 
C8A0 
C8A2 
C8A4 
C8A6 
C8A9 
C8AC 
C8AC 
C8AC 
C8AC 
C8AC 
C8AF 
C8B2 
C8B2 
C8B2 
C8B2 
C8B3 
C8B6 
C8B8 
C8BA 
C8BD 
C8BD 
C8BD 
C8BD 
C8BD 
C8C0 
C8C2 
C8C5 
C8C8 
C8CB 
C8CD 
C8CF 
C8D1 
C8D4 
C8D5 
C8D6 
C8D7 
C8D8 
C8DB 
C8DC 

:8dc 

C8DC 
C8DC 
C8DC 
C8DC 



>£ 

10 
EO 

DO 
2C 

AE 
I') 
EO 
FO 

zc 

2>3 
C9 

BO 

20 



00 CO 

13 C8A0 

93 

OF C8A0 

10 CO 

00 CO 

FB C894 

83 

03 C8A0 

10 CO 

7F 

20 

06 C8AC 

D2 CA 

BD C8 



C8AC 



7B 06 
38 CE 



7B 05 

21 

03 C8BD 

51 CB 



FB 04 

F7 

FB 04 

7B 05 

IF CO 

02 C8CF 

00 

24 

7B 04 



7B 06 



1 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 

2 '- 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
28 

3 9 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 



LDX 
BPL 
CPX 
BNE 
BIT 

KBDWAIT LDX 
BPL 
CPX 
BEQ 
BIT 

NOWAIT AND 
CMP 
BCS 
JSR 
JMP 



KBD 

NOWAIT 

#$93 

NOWAIT 

KBDSTRB 

KBD 

KBDWAIT 

#$83 

NOWAIT 

KBDSTRB 

#$7F 

#$20 

RPNCTL 

CTLCHARO 

CTLON 



IS KEY PRESSED? 

NO 

IS IT CTL-S? 

NO, IGNORE IT 

CLEAR STROBE 

WAIT FOR NEXT KEYPRESS 



IF CTL-C, LEAVE IT 
IN THE KBD BUFFER 
CLEAR OTHER CHARACTER 
drop possible ht bit 
IS IT CONTROL CHAR? 
=>NOPE 

execute CTL if M.CTL 
;=>enable ctl chrs 



■ 



ok 



* NOT A CTL CHAR. PRINT IT. 



BPNCTL 



EQU 
LDA 
JSR 



CHAR ;get char (all 8 bits) 
STORCHAR ;and display It 



* BUMP THE CURSOR HORIZONTAL: 



INY 




,bump It 


STY 


OURCH 


are we past the 


CFY 


WNDWDTH 


, end of the line? 


BCC 


CTLON 


=>N0, NO PROBLEM 


JSR 


X.CR 


YES, DO C/R 



M.CTL is set by RDCKAR and cleared here, after each 
character is displayed. 



CTLON 



LDA 
AND 
STA 
BIORET LDA 
BIT 
BPL 
LDA 
SETALL STA 
STA 

52 GETREGS PLA 

53 

54 

55 

56 

57 

25 
1 * 



MODE jenable printing of control chars 

#255-M.CTL 

MODE 

;get newest cursor position 

;IN 80 -MODE? 

;=>no, set other cursors 

;pin CH to for 80 columns 



OURCH 

RD80VID 

SETALL 

//0 

CH 

OLDCH 



TAX 
PLA 
TAY 
LDA 
RTS 
INCLUDE BINPUT 



CHAR 



;REMEMBER THE SETTING 
; RE STORE 

;X AND Y 



; RETURN TO BASIC 



A4 24 



* BASIC input entry point called by entry point in the 

* $C3 space. This ie the way things normally happen. 

* 

BINPUT LDY CH 
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C8DE 
C8E1 
C8E3 
C8E6 
C8E9 
C8EC 
C8EF 
C8F2 
C8F3 
C8F3 
C8F3 
C8F3 
C8F3 
C8F3 
C8F3 
C8F3 
C8F3 
C8F6 
C8F8 
C8FA 
C8FC 
C8FE 
C901 
C903 
C906 
C906 
C908 
C90A 
C90A 
C90A 
C90A 
C90C 
C90E 
C911 
C914 
C916 
C919 
C91B 
C91B 
C91B 
C9LB 
C91B 
C9LB 
C91B 
C91B 
C91B 
C91B 
C9U 
C91B 
C91B 
C91B 
C91B 
C91B 
C91B 



7B 06 
28 

50 C8 
26 CE 
3B G8 
7B 06 
26 CE 



FB 04 

08 

CB C8C5 

8D 

08 C906 

FB 04 

F7 

FB 04 

C906 
9B 
1L C9LB 



95 

B7 C8C5 

7B 05 

44 CE 

80 

7B 06 

AA C8C5 



LDA 
STA 
JSR 
B, INPUT JSR 
JSR 
STA 
JSR. 
TAY 



6 

7 

8 

9 

10 
11 
12 
13 
14 
15 
16 
17 
L8 
19 
20 
21 * 
22 
23 
2* 
25 
26 
27 
28 
29 

30 NOTACR 
31 
32 

33 * 
34 
35 
36 
37 
18 
39 
40 
41 
42 
43 
44 
45 
46 
47 

Mb 

49 
50 
51 
52 
53 
54 
57 
58 
59 
60 
61 



CHAR 

(BASL),Y 

CSETUP 

INVERT 

GETKEY 

CHAR 

INVERT 



;get newest cursor 

; invert that char 

;GET A KEY 

;SAVE IT 

; REMOVE CURSOR 

; preserve ace. 



On pure input, an uninterpreted character code should 
be returned. If M.CTL is set, however, escape functions 
are enabled, and CTL-U causes the character under the 
cursor to be picked up from the screen. 
M.CTL is set whenever a character is requested using 
RDCHAR in the $F8 ROM. 



LDA 
AND 
BEQ 
CPY 

BNE 
LDA 
AND 
STA 
EQU 
CPY 
BEQ 



;is escape mode enabled? 



MODE 

#M.CTL 

BIORET 

#S8D 

NOTACR 

MODE 

#255-M.CTL ;else end of line... 

MODE ; disable escape 



;=>no .return 
;was it a CR 
;=>nope, not 



CR 



#$9B 
ESCAPING 



; ESCAPE KEY? 
;=>YES IT IS 



* Not an escape sequence. Check for control-u. 



;is it controI-U? 

;no, return to caller 

;get horizontal position 

;and pick up the char 

jalways pick as normal 

;save keystroke 

;=>(always) return to caller 



Start an escape sequence. If the next character 
pressed is one of the following, it is executed. 
Otherwise it is ignored. 



CPY 


#$95 


BNE 


BIORET 


LDY 


OURCH 


JSR 


PICK 


0RA 


#$80 


STA 


CHAR 


BNE 


BIORET 



home & clear 

clear to end of line 

clear to end of screen 

move cursor up 

move cursor left 

move cursor right 

move cursor down 

enter 40 column mode 
8 - enter 80 column mode 
CTL-D- disable the printing of control characters 
CTL-E- enable the. printing of control characters 
CTL-Q- quit (PR#0/IN#0) 



.... 
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C91B 
C9IB 
C91B 
C91B 
C91B 
C91E 
C921 
C924 
C927 
C929 
C92B 
C92E 
C930 
C931 
C933 
C935 
C935 
C935 
C938 
C93A 
C93D 
C940 
C942 
C944 
C944 
C944 
C945 
C948 
C94A 
C94C 
C94F 
C951 
C954 
C957 
C957 
C959 
C95B 
C95D 
C960 
G963 
C963 
C965 
C967 
C969 
C96B 
C96B 
C96B 
C96B 
C96B 
C96B 
C96B 
C96B 
C96B 
C96C 



A8 
AD 
CO 
DO 
2G 
A3 
8D 
4C 

CO 
DO 

2 9 
8;j 
4C 

GO 
DO 
09 
DO 



C91B 
Bl CE 

3B C8 

C4 CE 

14 CE 

7F 

10 

7C C9 

05 C935 



F8 
OF 



C92B 
C944 



C935 
6B C9 
7F 

D6 CA 
6B C9 
D9 C91B 
A2 C8E6 

C944 

FB 04 

11 

OB C957 

4D CD 

98 

7B 06 

C5 C8 



5 
08 
DF 

FB 04 
E6 C8 

04 

F9 
20 
F2 



C963 



C960 



C95D 



C96B 



DC 
IC 



62 
6 3 
64 

6 5 
66 
67 
68 
69 
J 
71 
72 
73 
74 
75 

7 6 
7 7 
78 
79 
80 
&l 
82 
83 
8- 
85 
86 

87 

88 
89 

JO 

91 
92 
93 

9a 

95 
96 

9/ 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 



The four arrow keys (as IJKM) 



MSB 
ESCAPING EQU 
JSR 
JSR 
JSR 
JSR 
AND 
LDY 
ESC2 CMP 
BEQ 
DEY 
BPL 
BMI 



OFF 
* 

ESCON 

GETKEY 

ESCOFF 

UPSHFT 

tf$7F 

#ESCNUM-1 

ESCTAB.Y 

ESC3 

ESC2 
ESC SPEC 



ESC 3 



EQU 
LDA 
AND 
JSR 
LDA 
BMI 
BPL 
* 

ESC SPEC EQU 
TAY 



ESCCHAR.Y 
#$7F 

CTLCHAP 

ESCCRAR.Y 
ESCAPING 
B. INPUT 



ESCAPE CURSOR ON 

GET ESCAPE FUNCTION 

REPLACE ORIGINAL CHARACTER 

upshift the char 

DROP HI BIT 

COUNT/INDEX 

IS IT A VALID ESCAPE? 

=>YES 

TRY 'EM ALL... 

=>MAYBE IT'S A SPECIAL ONE 



GET CHAR TO "PRINT" 

DROP HI BIT (FLAG) 

EXECUTE IT 

GET FLAG 

=>STAY IN ESCAPE MODE 

=>QUIT ESCAPE MODE 



put char here 

so we can put this here 

was It Quit? 

=>no 

do the quitting stuff 
make it look like 
CTL-X was pressed 
=>quit the card forever 

was it CTL-E for enable 
=>no 

;yes, enable ctl chars 
save new mode 
=> exit eseape mode 

was it CTL-D for disable 
=>no, exit escape mode 
disable ctl chars 
=> exit escape mode 



This table contains the control characters which, 
when executed, carry out the escape functions. If 
the high bit of the character is set, it means that 
escape mode should not be exited after execution of 
the character. 





LDA 


MODE ; 




CPY 


#$11 ; 




BNE 


ESCSPl ; 




JSR 


X.NAK ; 




LDA 


/i$98 ; 




STA 


CHAR ; 


■A- 


JMP 


BIORET ; 


ESCSP1 


CPY 


#$05 ; 




BNE 


ESCSP4 ; 




AND 


#255-M.CTL2 


ESCSP2 


STA 


MODE ; 


ESCSP3 
it 


JMP 


B. INPUT ; 


ESCSP4 


CPY 


#$04 ; 




BNE 


ESCSP3 ; 




ORA 


#M.CTL2 ; 




BNE 


ESCSP2 ; 



ESC CHAR EQU 
DFB 
DFB 



$0C 
$1C 



:A: 



FORMFEED 
FS 
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C96D 
C96F, 
C96F 
C970 
C971 
C972 
C973 
C97 4 
C975 
C97 6 
C977 
C97 8 
C979 
C97A 
C97B 
C97C 
C97C 
C97C 
C97C 
C97D 
C97E 
C97F 
C980 
C981 
C982 
C983 
C984 
C985 
C986 
C987 
C988 
C989 
C98A 
C98B 
C98C 
C98D 
C98D 
C98D 
C98D 
C98D 
C98D 
C990 
C992 
C994 
C997 
C99A 
C99D 
C9A0 
C9A3 
C9A4 
C9A4 
C9A4 
C9A4 
C9A4 



D8 
DA 

IF 
ID 
OB 
9F 

9c; 
BA 

11 
12 

88 
8A 

4C 



40 
41 
4? 
43 
44 
45 
46 
49 
4A 
4B 
4D 
34 

08 

-A 
OB 

15 



0011 



C9A3 



CO 



2C 13 CO 
30 II 
A9 EE 
8D 05 
8D 03 CO 
8D 00 OC 
8D 00 08 
CD 00 OC 
60 



CA GB CD C9 



116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 



DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 

MSB 



$08 

SOA 

$1F 

$1D 

$0B 

$lF+$80 

$08+$80 

$lC+$80 

S0A+S80 

Sii 

$12 

$08+$80 

SOA+$B0 

$lF+$80 

$1C+$8Q 



C97C 133 ESCTAB EQU 



OFF 
* 

@ 

A 
B 
C 

D 
E 
F 
1 
J 
K 
M 
4 



BS 
LF 
US 
GS 
VT 

US (STAY 
BS (STAY 
FS (STAY 
LF (STAY 
:DC1 
8 :DC2 
<-:BS (STAY 
DN:LF (STAY 
UP: US (STAY 
->:FS (STAY 



ESC) 
ESC) 
ESC) 
ESC) 



ESC) 
ESC) 
ESC) 
ESC) 



134 ASC 

135 ASC 

136 ASC 

137 ASC 

138 ASC 

139 ASC 

140 ASC 

141 ASC 

142 ASC 

143 ASC 

144 ASC 

145 ASC 

146 ASC 

147 DFB 

148 DFB 

149 DFB 

150 DFB 

151 ESCNUM EQU 

152 MSB 

153 * 

154 * Tack on diag 128K tes 

155 * 

156 STAUX BIT 

157 BMI 

158 LDA 

159 STA 

160 STA 

161 STA 

162 STA 

163 CMP 

164 XSTAUX RTS 

165 * 

166 * ESCOUT used by ESCFIX 

167 * 

1 68 MSB 

169 ESCOUT ASC 



;high bit already masked 



; HANDLE OLD ESCAPES 



$08 

$0A 

$OB 

S15 

*-ESCTAB 

ON 



RDRAMRD 

XSTAUX 

//$EE 

WRCARDRAM 

RDCARDRAM 

$C00 

$800 

$C00 



ON 

' JKMI ' 



LEFT ARROW 
DOWN ARROW 
UP ARROW 
RITE ARROW 



t here 



aux done yet? 
=>yes, exit 
;get test pattern 
write AUX RAM 
I read AUX RAM 
test this byte 
;and this is IK off 
has SCOO been updated? 
;check in main diags. 

in SCI page 



;The arrows 



.- 
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C9A8 
C9A8 
C9A8 
C9A8 
C9A8 
C9A8 
C9AA 

S 
C9AA 
C9AA 
C9AD 
C9B0 
C9B0 
C9B0 
C9B0 
C9B0 
C9B0 
C9B0 
C9B0 
C9B2 
C9B4 
C9B4 
C9B6 
C9B6 
C9B6 
C9B7 
C9B7 
C9B7 
C9B7 
C9BA 
C9BC 
C9BD 
C9BF 
C9C0 
C9C0 
C9C0 
C9C1 
C9C4 
C9C7 
C9CA 
C9CD 
C9D0 
C9D3 
C9D6 
C9D6 
C9D6 
C9D6 
C9D6 
C9D6 
C9D6 
C9D6 
C9D9 
C9DC 
C9DE 



0002 
0000 



AD 7B 06 
4C 56 C3 



C9B0 
A9 83 

DO 02 C9B6 
C9B4 
A9 81 



C9B6 



4 8 



20 90 CA 

FO 04 C9G0 

68 

A2 09 

60 



C9CO 



68 

8D FB 04 
8D 01 CO 
8D OD CO 
8D OF CO 
20 D4 CE 
20 90 CC 
4C IF CA 



C9D6 



20 D4 CE 
20 3B C8 
29 7F 
8D 7B 06 



170 MSB OFF 
26 INCLUDE PASCAL 

1 **************************************** 

2 * PASCAL 1.0 OUTPUT HOOK: 

3 **************************************** 

4 DS C80RG+S1AA-*,0 

5 IFNE *-C80RG-$lAA 

6 FAIL2,'C9AA HOOK ALIGNMENT' 

7 FIN 

8 LDA CHAR ;GET OUTPUT CHARACTER 

9 JMP JPWRITE ;=>USE STANDARD WRITE 
JO **************************************** 

11 * 

12 **************************************** 

13 * PASCAL INITIALIZATION: 

14 * Disable printing of mouse text 

15 **************************************** 



Lb 

17 
L8 



PINIT1.0 EQU 
LDA 
BNE 



#M.PASCAL+M.PAS1 ,0+M. MOUSE 
PINIT2 ;=>always 



19 PINIT EQU * 
20 

21 * 

22 PINIT2 
23 



LDA #M,PASCAL+M. MOUSE ;SAY WE'RE 

EQU * 
PHA 



24 

25 

26 * 

27 

28 

29 

30 

31 

32 * 

33 PIGOOD 



;save version ID 
SEE IF THE CARD'S PLUGGED IN: 



JSR 
BEQ 
PLA 
LDX 
RTS 



TESTCARD ; IS IT THERE? 
PIGOOD ;=>YES 

jdiscard ID byte 
#9 ;IORESULT=' NO DEVICE' 



EQU * 

PLA ;get version ID 

STA MODE ; and save it 

STA SET80COL ; ENABLE 80 STORE 

STA SET80VID ; AND 80 VIDEO 

STA SETALTCHAR ;N0RM+INV LCASE 

JSR PSETUP ;set window and cursor 

JSR X.FF ;HOME & CLEAR IT 

JMP DOBASL ;fix OLDBASL/H, display cursor, exit 

42 **************************************** 

43 * PASCAL INPUT: 
* 

* Character always returned with high bit clear. 

* 

**************************************** 

48 PREAD EQU * 

49 JSR PSETUP ; SETUP ZP STUFF 
JSR GETKEY ;GET A KEYSTROKE 
AND #S7F ;DROP HI BIT 
STA CHAR ;SAVE THE CHAR 



34 
35 

36 
3 7 
38 
3 9 
40 
4] 



44 

45 

46 
4 7 



5(3 
51 

52 



Appendix I: Monitor ROM Listings 



325 



C9E1 

C9E3 

C9E6 

C9E8 

C9EA 

C9EC 

C9EC 

C9EC 

C9EF 

C9F0 

C9F0 

C9F0 

C9F0 

C9F0 

C9F0 

C9F0 

C9F0 

C9F2 

C9F3 

C9F6 i 

C9F8 

C9FB 

C9FD 

C9FE 

CA01 

CA03: 

CA06 

CA08: 

CAOA 

CAOC: 

CAOF 

CAIO: 

CA13: 

CA15: 

CA17; 

CA19: 

CA1C 

CA1F: 

CA21! 

CA24; 

CA26: 

CA29; 

CA2C: 

CA2E: 

CA2F: 

CA2F: 

CA2F: 

CA2F: 

CA32: 

CA33: 

CA34: 

CA36! 

CA39: 

CA3B: 



A2 00 
AD FB 
29 02 
FO 02 
A2 C3 



AD 7B 
60 



04 



C9EC 
C9EC 



06 



C9F0 



29 7F 
AA 

20 D4 
A9 08 
2C FB 
DO 32 
8A 

2G 2E 
FO 50 
AC 7B 
24 32 
10 02 
09 80 
20 70 
C8 

8C 7B 
C4 21 
90 08 
A9 00 
8D 7B 
20 D8 
A5 28 
8D 7B 
A5 29 
8D FB 
20 IF 
A2 00 
60 



20 IF 
8A 
38 

E9 20 
2C FB 
30 30 



CE 

04 
t 

CA 
( 

05 

C 
CE 

05 



CA2F 



CA53 



CAOC 



CA1F 



05 
CB 

07 

07 

CE 



CE 



PASCAL OUTPUT: 

Note: to be executed, control characters must have 
their high bits cleared. All other characters are 
displayed regardless of their high bits. 



06 



CA6B 



53 
54 
55 
56 
57 
58 
59 
60 
61 
o? 
63 
64 
65 
66 

67 * 

68 PWRITE EQU * 

69 AND #$7F 
TAX 
JSR 
LDA 
BIT 
BNE 
TXA 
BIT 
BEQ 
LDY 
BIT 
BPL 
ORA 
JSR 
I NY 
STY 
CPY 
BCC 
LDA 
STA 
JSR 
LDA 
STA 

92 LDA 

93 STA 

94 PWRITERET JSR PASINV 

95 PRET LDX #$0 

96 PRTS RTS 

97 * 
98 
99 * 

100 GETX JSR 

101 TXA 

102 SEC 

103 SBC 

104 BIT 

105 BMI 

106 * 



LDX #0 




;I0RESULT='GO0D' 


LDA MODE 




;ARE WE IN 1.0 -MODE? 


AND CM.FAS1 


.0 




BEQ PRE AD RE T2 


;=>N0PE 


LDX #<CN00 




;YES, RETURN CN IN X 


2 EQU * 






LDA CHAR 




; RESTORE CHAR 


RTS 







7 
71 

72 

73 

74 

7 5 

76 

77 

7 a 

79 

80 

81 

82 PWR1 

83 

84 

95 

86 

87 

88 

89 

90 DOBASL 

91 



PSETUP 
#M.G0XY 
MODE 
GETX 

PRTS 

PCTL 

OURCH 

INVFLG 

PWR1 

#$80 

STOUT 

OURCH 

WNDWDTH 

DOBASL 

#0 

OURCH 

X.LF 

BASL 

OLDBASL 

BASH 

OLDBASH 



clear high bits 

save character 

SETUP ZP STUFF, don't set ROM 

ARE WE DOING GOTOXY? 

=>Doing X or Y? 

now check for control char 

is it control? 

■>yes, do control 

get horizontal position 

check for inverse 

inverse, go store it 

now store it (erasing cursor) 
INC CH 



;do carriage return 

;and linefeed 

;save BASL for pascal 



-.display new cursor 
;return with no error 



HANDLE GOTOXY STUFF: 



PASINV 



#32 

XCOORD 

PSETX 



;turn off cursor 
;get character 

;MAKE BINARY 
;doing X? 
;=>yes, set it 



- 
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CA3B 








107 


* 


Set Y 


and 


do the GOTOX* 




CA3B: 








108 


* 










CA3B 


8D 


KB 


05 


109 


GETY 


STA 


OURCV 




CA3E. 


85 


25 




110 






STA 


CV 




CA40 


20 


HA 


CA 


111 






JSR 


BASCALC ;calc base addr 


CA43: 


AD 


KB 


06 


112 






LDA 


XCOORD 




CA46 


HI) 


7B 


05 


113 






STA 


OURCH ;set cursor horizontal 


CA49' 


A9 


F7 




114 






LDA 


#255-M.G0XY 


;turn off gotoxy 


CA48 


21) 


FB 


04 


115 






AND 


MODE 




CA4E 


8D 


FB 


04 


116 






STA 


MODE 




CA51 


DO 


cc 


CA1F 


117 






BNE 


DOBASL ;= 


=>D0NE (ALWAYS TAKEN) 


CA53; 








118 


* 










CA53 


20 


IF 


CK 


119 


PCTL 


JSR 


PASINV ;turn off cursor 


CA56 


8A 






120 






TXA 


;get char 


CAS 7 


C9 


IE 




121 






CMP 


#S1E ;i 


s it gotoXY? 


CAS 9 


FO 


06 


CA61 


122 






BEQ 


STARTXY ;= 


>yes, start it up 


CA5B 


20 


D6 


CA 


123 






JSR 


CTLCHAR [EXECUTE IT IF POSSIBLE 


CASE 


4C 


IF 


CA 


124 






JMP 


DOBASL ;= 


>update BASL/H, cursor, exit 


CA61 








125 


* 










CA61 








126 


* 


START 


THE 


GOTOXY SEQUENCE: 


CA61 








127 


* 










CA6i 






CA61 


128 


STARTXY 


EOU 


* 




CA61 


A9 


8 




129 






LDA 


#M.GOXY 




CA63 


on 


KB 


04 


130 






ORA 


MODE ;turn on gotoxy 


CA66 


SD 


FB 


04 


131 






STA 


MODE 




CA69 


A9 


FF 




132 






LDA 


#$FF ;set XCOORD to -1 


CA6B 


80 


FB 


06 


133 


PSETX 


STA 


XCOORD ;set X 


CA6E 


4C 


29 


CA 


134 






JMP 


PWRITERET ;=>display cursor and exit 


CA71 








27 






INCLUDE SUBS1 




CA71 






CA71 


1 


DOMN 


EQU 


* 




CA71 


AA 






2 






TAX 


;SAVE IT 


CA72 


A5 


2A 




3 






LDA 


BAS2L ;GET OPCODE AGAIN 


CA74 


AO 


03 




4 






LDY 


#$03 




CA76 


BO 


8 A 




5 






CPX 


#$8A 




CA78 


FO 


03 


CA85 


6 






BEQ 


MNNDX3 




CA7A 


4A 






7 


MNNDX1 


LSR 


A 




CA7B 


90 


08 


CAS 5 


8 






BCC 


MNNDX3 ;F0RM INDEX INTO MNEMONIC TABL 


CA7D 


4 A 






9 






LSR 


A 




CA7E 


4A 






10 


MNNDX2 


LSR 


A 


1) 1XXX1010 => 00101XXX 


CA7F 


09 


20 




11 






ORA 


#$20 


2) XXXYYY01 => 00111XXX 


CA81 


88 






12 






DEY 




3) XXXYYYLO => 00110XXX 


CA82 


DO 


FA 


CA7E 


13 






BNE 


MNNDX2 


4) XXXYY100 => 00100XXX 


CA84 


C8 






14 






INY 




5) XXXXXOOO => 00OXXXXX 


CAS 5 


88 






15 


MNNDX3 


DEY 






CA86 


DO 


F2 


CA7A 


16 






BNE 


MNNDXl 




CA88 


60 






17 






RTS 






CA89 








18 


* 










CA89 








19 


* 


Switch In 


slot 3, then 


test for a ROM card. 


CA89 








2 


* 


If none found, test foi 


- 80 column card, 


CA89 








21 


* 


else 


return with BNE. 




CAS 9 








22 


* 










CAS 9 






CA89 


2 3 


TSTROMCRD EQU * 




CAS9 


20 


37 


F8 


2<4 






JSR 


TSTROM ;1 


:est for ROM card 


CA8C 


DO 


)2 


CA90 


25 






BNE 


TESTCARD ; = 


=>no ROM, check for 80 column 
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CA8E:C8 




26 






INY 




;make BNE for return 


CA8F:60 




27 






RTS 






CA90: 




28 


* 










CA90: 




29 


**************************************** 


CA90: 




30 


* 


NAME 




TESTCARD 




CA90: 




31 


* 


FUNCTION: 


SEE IF 80COL CARD PLUGGED IN 


CA90: 




32 


* 


INPUT 




NONE 




CA90: 




33 


* 


OUTPUT : 


'BEQ' IF CARD AVAILABLE 


CA90: 




U 


k 






'BNE' IF NOT 


CA90: 




35 


-k 


VOLATILE: 


AC.Y 




CA90: 




36 


**************************************** 


CA90: 




3 7 


* 










CA90: 


CA90 


38 


TESTCARD EOL 


* 




CA90:ATi 1C 


CO 


39 






LDA 


RDPAGE2 


; REMEMBER CURRENT VIDEO DI 


CA93:0A 




40 






ASL 


A 


IN THE CARRY 


CA94:A9 88 




41 






LDA 


#$88 


.USEFUL CHAR FOR TESTING 


CA96:2C 18 


CO 


^ 






BIT 


RD80COL 


REMEMBER VIDEO MODE IN 'N 


CA99:8D 01 


CO 


43 






STA 


SET80C0L 


ENABLE 80COL STORE 


CA9C:08 




44 






PHP 




SAVE 'N' AND *C FLAGS 


CA9D:8D 55 


CO 


45 






STA 


TXTPAGE2 


SET PAGE2 


CAAO:AC 00 


04 


4 6 






LDY 


$0400 , 


GET FIRST CHAR 


CAA3:8D 00 


04 


47 






STA 


$0400 


SET TO A '*' 


CAA6:AD 00 


04 


48 






LDA 


$0400 ; 


GET IT BACK FROM RAM 


CAA9:8C 00 


04 


49 






STY 


$0400 


RESTORE ORIG CHAR 


CAAC:28 




50 






PLP 




RESTORE 'N 1 AND 'C FLAGS 


CAADiBO 03 


CAB2 


51 






BCS 


STAY2 , 


STAY IN PAGE 2 


CAAF:8D 54 


CO 


52 






STA 


TXTPAGE1 ; 


RESTORE PAGE1 


CAB2 : 


CAB2 


53 


STAY 2 


EQU 


* 




CAB2:30 03 


CAB7 


54 






BMI 


STAY80 j 


=>STAY IN 80COL MODE 


CAB4:8D 00 


CO 


55 






STA 


CLR80C0L ; 


TURN OFF 80C0L STORE 


CAB7: 


CAB7 


56 


STAY80 


EQU 


* 




CAB7:C9 88 




57 






CMP 


#$88 ; 


WAS CHAR VALID? 


CAB9:60 




58 






RTS 


* 


RETURN RESULT AS BEQ/ BNE 


CABA: 




59 


* 










CAB A: 




60 


* 


Do the 






normal monitor ROM 


BASCALC 








CABA: 




61 


X 










CABA: 


CABA 


62 


BASCALC 


EQU 


* 




CABA: 48 




63 






PHA 






CABB:4A 




64 






LSR 


A 




CABC:29 03 




65 






ANB 


#$03 




CABE:09 04 




66 






ORA 


#$04 




CAC0:85 29 




67 






STA 


BASH 




CAC2:68 




68 






PLA 






CAC3:29 18 




69 






AND 


#$18 




CAC5:90 02 


CAC9 


70 






BCC 


BSCLC2 




CAC7:69 7F 




71 






ADC 


f$7F 




CAC9:85 28 




72 


BSCLC2 


STA 


BASL 




CACB:0A 




73 






ASL 


A 




CACC:0A 




74 






ASL 


A 




CACD:05 28 




75 






ORA 


BASL 




CACF:85 28 




7 6 






STA 


BASL 




CAD1:60 




7 7 






RTS 






CAD2: 




78 


A 
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CAD2 
CAD2 
CAD2 
CAD2 
CAD2 
CAD2 
CAD2 
CAD2 
CAD2 
CAD2 
CAD2 
CAD5 
CAD6 
CAD6 
CAD6 
CAD6 
CAD6 
CAD6 
CAD6 
CAD6 
CAD 6 
CAD 6 
CAD6 
CAD6 
CAD6 
CAD7 
CADA 
CADB 
CADC 
CADD 
CADD 
CAEO 
CAE2 
CAE4 
CAE7 
CAE9 
CAEB 
CAEB 

S 
CAEB 
CAEB 
CAED 
CAED 
CAED 
CAFO 
CAF3 
CAF5 
CAF7 
CAF7 
CAF7 
CAF8 
CAFA 
CAFA 
CAFD 



79 **************************************** 



06 CB 
FE CADS 
CAD6 



7B 07 



7B 07 
05 

13 CAF7 
B4 CB 
OE CAF7 
12 CAFD 



0000 



30 10 CAFD 



7B 07 

FB 04 

28 

03 CAFA 

CAF7 

09 CB03 

7B 07 

CAFD 



CTLCHARO 

Execute CTL char if M.CTLO 
AC=CHAR 

'BCS' if not executed 
: 'BCC' if executed 
VOLATILE: NOTHING 

MANY THINGS 



NAME 

FUNCTION 
INPUT 
OUTPUT 



80 
81 

m;> 
S3 

8 5 

8b 

87 

38 * 

89 CTLCHARO BIT SEV1 



* CALLS 
**************************************** 



;set V (use M.CTL) 
;skip CLC 



90 BVC * 

91 ORG *-I 

92 * 

93 **************************************** 

94 * NAME : CTLCHAR 

95 * FUNCTION: Always execute CTL char 

96 * INPUT : AC=CHAR 

97 * OUTPUT ! 'BCS' if not executed 

98 * : 'BCC if ctl executed 

99 * VOLATILE: NOTHING 

100 * CALLS : MANY THINGS 

101 **************************************** 

102 * 



103 CTLCHAR CLV 

104 STA 

105 PHA 

106 TYA 

107 PHA 

108 * 

109 LDY 

110 CPY 

111 BCC 

112 LDA 

113 BEQ 

114 BVC 

115 * 

116 DO 

117 BPL 

118 ELSE 

119 BMI 

120 FIN 

121 * 

122 STA 

123 LDA 

124 AND 

125 BEQ 

126 * 

12 7 CTLCHARX EQU 

128 SEC 

129 BCS 

130 * 

131 CTLGO LDA 

132 CTLGOO EQU 



;clear V {ignore M.CTL) 
TEMPI ;TEMP SAVE OF CHAR 
;SAVE AC 
;SAVE Y 



TEMPI ;GET CHAR IN QUESTION 
#$05 ;IS IT NUL..EOT? 
CTLCHARX ;=>YES, NOT USED 
CTLADH-5.Y ;Get high byte of address 



CTLCHARX 
CTLGOO 

TEST 
CTLGOO 

CTLGOO 



TEMPI 
MODE 



;=>ctl not implemented 

;=> CLTCHAR: always execute 



=>CR,BEL,LF,BS always done 
=>CR,BEL,LF,BS always done 



;save high byte of address 
;if control chars 



#M.CTL+M.CTL2 ;are enabled 
CTLGO ;=>then go do them 



;SAY 'NOT CTL' 
CTLRET ;=>D0NE 

TEMPI ;get address back 
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CAFD 

S 
CAFD 
CAFD 
CAFF 
CAFF 
CB02 
CB02 
CB03 
CB03 
CB04 
CB05 
CB06 
CB07 
CB07 
CB07 
CB08 
CBOB 
CBOC 
CBOD 
CBOD 
CBOD 
CBOD 
CB10 
CB12 
CB14 
CB17 
CB18 
CB18 
CB18 
CB18 
CB18 
CB1B 
CB1D 
CB1F 
CB21 
CB21 
CB21 
CB21 
CB21 
CB23 
CB26 
CB28 
CB2A 
CB2D 
CB30 
CB3I 
CB33 
CB34 
CB34 
CB34 
CB35 
CB36 
CB38 



OOOO 



09 80 
20 07 

18 

68 
A8 
68 
60 



48 

B9 99 

48 

60 



AD FB 
10 05 
29 EF 
8D FB 
60 



CS 



CB03 



CB07 



CB 



04 



CB17 



04 



AD FB 
10 FA 
09 10 
DO F3 



A9 40 
20 34 
AO CO 
A9 OC 
20 34 
AD 30 
88 

DO F5 
60 



38 
48 

E9 OL 
DO FC 



04 



CB17 
CB14 

CB21 



CB 



CB 
CO 



CB28 



CB34 



CB36 



133 
134 
135 
136 
137 
138 

139 * 

140 CLC 

141 CTLRET EQU 

142 PLA 

143 TAY 

144 PLA 

145 SEV1 RTS 

146 * 
CTLXFER EQU 

PKA 
LDA 
PKA 
RTS 



DO TEST 

AND #$7F 

ELSE 

ORA #$80 

FIN 

JSR CTLXFER 



147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 



;for test, hi bit clear 
;hl bit always set 
; EXECUTE SUBROUTINE 
;SAY 'CTL CHAR EXECUTED' 
; RESTORE 

; v 

; AND AC 



PUSH ONTO STACK FOR 
; TRANSFER TRICK 



CTLADL-5.Y 

;XFER TO ROUTINE 
Turn cursor on for Pascal only 



X. CUR. ON LDA MODE ;get mode byte 

BPL CURON.X ;=>not pascal, don't do it 
AND #255-M. CURSOR ; clear cursor bit 

SAVCUR STA MODE ; save it 

159 CURON.X RTS ;and exit 

160 * 

* Turn cursor off for Pascal only. 

* Cursor is not displayed during call. 



BELL 



161 

162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 BELL2 

176 

177 

178 

179 

180 

181 * 

182 WAIT 
183 

184 WAIT2 

185 WAIT3 
186 



CUR. OFF LDA MODE ;get mode byte 

BPL CURON.X ;=>not pascal, don't do it 
ORA #M. CURSOR ;turn on cursor bit 



BNE SAVCUR 



EXECUTE BELL: 



EQU 
LDA 
JSR 
LDY 
LDA 
JSR 
LDA 
DEY 
BNE 
RTS 

EQU 
SEC 
PHA 
SBC 

BNE 



* 

#340 
WAIT 

#sco 

#$0C 
WAIT 

SPKR 

BELL2 



#1 

WAITS 



;save and exit 



; RIPPED OFF FROM MONITOR 



;RIPPED OFF FROM MONITOR ROM 
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CB3A 


68 








187 






PLA 






CB3B 


E9 


01 






188 






SBC 


n 




CB3D 


DO 


H 




CB35 


189 






BNE 


WAIT2 




CB3F- 


60 








190 






RTS 






CB40 










191 


* 










CB40 










192 


* 


EXECUTE BACKSPACE: 




CB40 










193 


* 










CB40 








CB40 


194 


X, 


BS 


EQU 


* 




CB40 


CE 


7B 


05 




195 






DEC 


OURCH 


BACK. UP CH 


CB43 


LO 


OB 




CB50 


196 






BPL 


BSDONE 


=>DONE 


CB45 


A5 


21 






197 






LDA 


WNDWDTH 


BACK UP TO PRIOR LINE 


CB47 


8B 


?B 


05 




198 






STA 


OURCH 


SET CH 


CB4A 


CE 


TB 


05 




199 






DEC 


OURCH 




CB4D 


20 


7 9 


CB 




200 






JSR 


x.us 


NOW DO REV LINEFEED 


CB50 








CB50 


201 


BSD ONE 


EQU 


* 




CB50 


60 








202 






RTS 






CB51 










203 


* 










CB51 










204 


* 


EXECUTE CARRIAGE RETUI 


IN: 


CB51 










205 


* 










CB51 








CB51 


206 


X 


CB 


EQU 


* 




CB51 


A 9 


00 






207 






LDA 


m 


BACK UP CH TO 


CB53 


BD 


7B 


05 




208 






STA 


OURCH 


BEGINNING OF LINE 


CB56 


M) 


FB 


04 




209 






LDA 


MODE 


ARE WE IN BASIC? 


CB59 


30 


03 




CB5E 


210 






BMI 


X. CRRET 


*> Pascal, avoid auto 


CB5B 


20 


D8 


CB 




211 






JSR 


X.LF 


EXECUTE AUTO LF FOR B 


CB5E 








CB5E 


212 


X 


CRRET 


EOU 


* 




CB5E 


60 








213 






RTS 






CB5F 










214 


* 










CB5F 










215 


* 


EXECUTE HOME: 




CB5F 










216 


* 










CB5F 








CB5F 


217 


X 


EM 


EQU 


* 




CB5F 


A5 


22 






218 






LDA 


WNDTOP 




CB61 


85 


25 






219 






STA 


CV 




CB63 


A9 


00 






220 






LDA 


#0 




CB65 


8D 


7B 


05 




221 






STA 


OURCH 


STUFF CH 


CB68 


4C 


FB 


CD 




222 






JMP 


VTAB 


set bass for OURCV 


CB6B 










223 


* 










CB6B 










224 


* 


EXECUTE FORWARD SPACE 




CB6B 










225 


* 










CB6B 








CB6B 


226 


X 


FS 


EQU 


■* 




CB6B 


EE 


7B 


05 




227 






INC 


OURCH 


BUMP CH 


CB6E 


■ID 


7B 


5 




228 






LDA 


OURCH 


,GET THE POSITION 


CB71 


C5 


2! 






229 






CMP 


WNDWDTH 


OFF THE RIGHT SIDE? 


CB73 


90 


03 




CB78 


230 






BCC 


X. FSRET 


;=>NO, GOOD 


CB75 


20 


51 


OS 




231 






JSR 


X.CR 


=>¥ES, WRAP AROUND 


CB78 










232 


* 










CB78 








CB78 


233 


X 


FSRET 


EQU 


* 




CB78 


60 








234 






RTS 






CB7 9 










235 


A 










CB79 










236 


k 


EXECUTE REVERSE LINEF1 


ZED: 


CB79 










237 


■k 










C879 


425 


22 






238 


X 


.IIS 


LDA 


WNDTOP 


;are we at top? 


:?"=. 


C5 


25 






239 






CMP 


CV 




CB7B 


BO 


LE 




CB9D 


240 






BCS 


X.USRET 


;=>yes, stay there 



Listings 



33] 



CB7F:C6 


2S 




241 




DEC 


CV ;else go up a line 


CB81:4C 


FF, 


CD 


242 




JMP 


VTAB ;exit thru VTAB (update 


CB84: 






243 * 








CB84: 






244 * 


EXECUTE "NORMAL VIDEO" 


CB84: 






245 * 








CB84: 




CB84 


246 X 


SO 


EQU 


* 


CB84:AD 


FB 


04 


247 




LDA 


MODE ;SET MODE BIT 


CB87;10 


02 


CB8B 


248 




BPL 


X.SOl ;don't set mode for BASIC 


CB89:29 


?!i 




249 




AND 


#255-M.VMODE ;SET 'NORMAL' 


CB8B:A0 


FF 




250 X 


.SOI 


LDY 


#255 


CB8D:D0 


09 


CB98 


251 




BNE 


STUFFINV ; (ALWAYS) 


CB8F: 






252 * 








CB8F: 






253 * 


EXECUTE "INVERSE VIDEO" 


CB8F: 






254 * 








CB8F: 




CB8F 


255 X 


SI 


EQU 


k 


CB8F:AD 


PB 


04 


256 




LDA 


MODE ;SET MODE BIT 


CB92:10 


0-2 


CB96 


257 




BPL 


X.SI1 jdon't set mode for BASIC 


CB94:09 


04 




258 




ORA 


#M.VMODE ;SET 'INVERSE' 


CB96:A0 


7F 




259 X. 


SI1 


LDY 


#127 


CB98:8D 


FH 


04 


260 STUFFINV STA 


MODE ;SET MODE 


CB9B:84 


30 




261 




STY 


INVFLG ; STUFF FLAG TOO 


CB9D:60 






262 X. 


USREI 


RTS 




CB9E: 






263 * 








CB9E: 




CB9E 


264 CTLADL 


EQU 


* 


CB9E;0C 






265 




DFB 


#>X.CUR.ON-l ;ENQ 


CB9F:17 






266 




DFB 


#>X.CUR.OFF-l ;ACK 


CBA0:20 






267 




DFB 


#>X.BELL-1 ;BEL 


CBAI:3F 






268 




DFB 


//>X.BS-1 ;BS 


CBA2:00 






269 




DFB 


;HT 


CBA3:D7 






270 




DFB 


<l>X.LF-i ;LF 


CBA4:73 






271 




DFB 


#>X.VT-1 ;VT 


CBA3:8F 






272 




DFB 


OX.FF-1 ;FF 


CBA6:50 






273 




DFB 


/>>X.CR-1 ;CR 


CBA7:83 






274 




DFB 


//>X.SO-l ;SO 


CBA8:8E 






275 




DFB 


/^X.SI-1 ;SI 


CBA9:00 






276 




DFB 


;DLE 


CBAAiF^ 






277 




DFB 


//>X.DC1-1 ;DC1 


CBAB:FB 






278 




DFB 


#>X.DC2-1 ;DC2 


CBAC:O0 






279 




DFB 


;DC3 


CBADrOO 






280 




DFB 


;DC4 


CBAE:4C 






281 




DFB 


#>X.NAK-1 ;NAK 


CBAF:D3 






282 




DFB 


OSCROLLDN-1 ;SYN 


CBBO:EA 






283 




DFB 


#>SCROLLUP-l ;ETB 


CBB1:3C 






284 




DFB 


#>MOUSEOFF-l 


CBB2;5E 






285 




DFB 


#>X.EM-1 ;EM 


CBB3:95 






286 




DFB 


#>X.SUB-1 ;SUB 


CBB4:43 






287 




DFB 


£>M0USE0N-1 


CBB5 : 6A 






288 




DFB 


#>X.FS-1 ;FS 


CBB6:99 






289 




DFB 


^>X.GS-1 ;GS 


C8B7:QQ 






290 




DFB 


;RS 


CBB8:78 






291 




DFB 


#>X.US-1 ;US 


CBB9: 






292 * 








CBB9: 




CBB9 


293 CTLADK 


EQU 


* 


CBB9:4B 






294 




DFB 


//<X.CUR.0N-$8001 :ENQ 






ndix I Moni 



■ 
■ 



CBBA 
CBBB 
CBBC 
CBBD 
CBBE 
CBBF 
CBCO 
CBC1 
CBC2 
CBC3 
CBC4 
CBC5 
CBC6 
CBC7 
CBC8 
CBC9 
CBCA 
CBCB 
CBCC 
CBCD 
CBCE 
CBCF 
CBDO 
CBD1 
CBD2 
CBD3 
CBD4 
CBD4 
CBD4 
CBD4 
CBD4 
CBD4 
CBD4 
CBD4 
CBD6 
CBD8 
CBD8 
CBD8 
CBD8 
CBD8 
CBDA 
CBDC 
CBDF 
CBE1 
CBE3 
CBE6 
CBE6 
CBE6 
CBE9 
CBEB 
CBEB 
CBED 
CBEE 
C3EF 



4B 

CB 
00 

CB 

4C 

4C 

OR 

4B 
00 
4C 
4C 
00 
00 

4n 
4B 
4B 
4D 
4B 
4C 
4D 
4B 
4C 
00 
4B 



AO 00 
FO 15 



CBED 



CBD8 
E6 25 
A5 25 

81) FB 05 
C5 23 

30 03 CBE6 
4C 03 CE 



CBE6 



CE FB 05 

C6 2 5 

AO 01 

SA 

48 

8C 7B 07 



295 

296 

297 

298 

299 

300 

301 

302 

303 

304 

305 

306 

307 

308 

309 

310 

311 

312 

313 

314 

315 

316 

317 

318 

319 

320 

28 

1 

2 

3 

4 

3 

6 

7 

8 

9 

LO 

11 

L2 

1 3 
14 
L5 
16 
17 
18 
19 
20 
21 
22 

2 3 
24 
2S 
26 
27 



DFB KX.CUR.0FF-S8001 ;ACK 

DFB KX.BELL-1 ;BEL 

DFB KX.BS-1 ;BS 

DFB ; HT 

DFB #<X.LF-1 ;LF 

DFB /KX.VT-S8001 ;VT 

DFB #<X.FF-S8001 ; FF 

DFB KX.CR-1 ;CR 

DFB KX.SO=$8001 ;S0 

DFB #<X.SI-$80GI ;SI 

DFB ;DLE 

DFB #<X.DC1-$8001 ;DC1 

DFB KX.DC2-S8001 ;DC2 

DFB ;DC3 

DFB ;DC4 

DFB /KX.NAK-S8001 ; NAK 

DFB KSCRQLLDN-S8001 ; SYN 

DFB KSCR.OLLUP-S8001 ; ETB 

DFB #<M0USEOFF-$8001 

DFB #<X.EM-$8001 ;EM 

DFB #<X.SUB-$8001 ;SUB 

DFB KMOUSEON-S8Q01 

DFB #<X.FS-S8001 ;FS 

DFB #<X.GS-$8001 ;GS 

DFB ;RS 

DFB #<X.US-$8001 ;US 
INCLUDE SUBS2 
* 

* SCROLLIT scrolls the screen either up or down, depending 

* on the value of X. It scrolls within windows with even 

* or odd edges for both 40 and 80 columns. It can scroll 

* windows down to 1 characters wide. 
* 

SCROLLDN LDY #0 ;direction = down 

BEQ SCROLLIT ;=>go do scroll 
* 

* EXECUTE LINEFEED: 



X.LF 



X.LF2 



EQU 
INC 

LDA 
STA 
CMP 
BCS 
JMP 

EQU 
DEC 
DEC 



CV 

CV 

OURCV 

WNDBTM 

X.LF2 

VTAB2 



OURCV 
CV 



-n 



SCS0LLUP LDY 
SCROLLIT TXA 

PRA 

STY TEMPI 



;SEE IF OFF BOTTOM 

;OFF THE END? 

;=>yes, scroll screen 

;exit thru VTABZ 



;baek up to bottom 
;and fall Into scroll 

;direction = up 
;save X 

;save direction 



dix I: Monitor ROM Listings 



■m 



CBF2:A5 


21 




28 




LDA 


WNDWDTH 


CBF4:48 






29 




PHA 




CBF5:2C 


IF 


CO 


30 




BIT 


RD80VID 


CBF8:10 


1C 


CC16 


31 




BPL 


GETST1 


CBFA:8D 


1 


CO 


3 2 




STA 


SET80COL 


CBFD:4A 






33 




LSR 


A 


CBFE:AA 






34 




TAX 




CBFF:A5 


20 




35 




LDA 


WNDLFT 


CC01:AA 






36 




LSR 


A 


CC02:B8 






37 




CLV 




CC03:90 


03 


CCO 8 


3K 




BCC 


CHKRT 


CC05:2C 


6 


CB 


39 




BIT 


SEV1 


CC08:2A 






40 


CHKRT 


ROL 


A 


CC09:45 


21 




41 




EOR 


WNDWDTH 


CC0B:4A 






4 2 




LSR 


A 


CCOC:70 


03 


ecu 


4 3 




BVS 


GETST 


CCOE : BO 


01 


ecu 


44 




BCS 


GETST 


CClOrCA 






45 




DEX 




CCll:86 


2L 




46 


GETST 


STX 


WNDWDTH 


CC13:AD 


IF 


CO 


47 




LDA 


RD80VID 


CC16:08 






us 


GETST1 


PHP 




CC17:A6 


22 




49 




LDX 


WNDTOP 


CC19:98 






50 




TYA 




CC1A:D0 


03 


CC1F 


51 




BNE 


SETDBAS 


CC1C:A6 


21 




52 




LDX 


WNDBTM 


CC1E:CA 






33 




DEX 




CC1F: 






54 


* 






CC1F:8A 






55 


SETDBAS 


TXA 




CC20:20 


3 


CE 


56 




JSR 


VTABZ 


CC23: 






57 


* 






CC23:A5 


28 




58 


SCRLIN 


LDA 


BASL 


CC25:85 


2A 




59 




STA 


BAS2L 


CC27:A5 


2-? 




60 




LDA 


BASH 


CC29:85 


2B 




61 




STA 


BAS2H 


CC2B: 






62 


* 






CC2B:AD 


78 


07 


63 




LDA 


TEMPI 


CC2E : FO 


32 


CC62 


64 




BEQ 


SCRLDN 


CC30:E8 






ft 5 




INX 




CC31:E4 


23 




66 




CPX 


WNDBTM 


CC33:BO 


32 


CC67 


67 




BCS 


SCRLL3 


CC35:8A 






68 


SET SRC 


TXA 




CC36:20 


03 


CE 


69 




JSR 


VTABZ 


CC39:A4 


21 




70 




LDY 


WNDWDTH 


CC3B:28 






71 




PLP 




CC3C:08 






72 




PHP 




CC3D:10 


IE 


CC5D 


73 




BPL 


SKPRT 


CC3F:AD 


5 5 


CO 


74 




LDA 


TXTPAGE2 


CC42:98 






7 5 




TYA 




CC43:FO 


07 


CC4C 


76 




BEQ 


SCRLFT 


CC45:B1 


28 




77 


SCRLEVEN LDA 


(BASL).Y 


CC47:91 


2A 




78 




STA 


(BAS2L),Y 


CC49:88 






79 




DEY 




CC4A:D0 


F9 


CC45 


80 




BNE 


SCRLEVEN 


CC4C:70 


04 


CC52 


81 


SCRLFT 


BVS 


SKPLFT 



get width of screen window 

save original width 

In 40 or 80 columns? 

=>40, determine starting line 

make sure this is enabled 

divide by 2 for 80 column index 

and save 

test oddity of right edge 

by rotating low bit into carry 

V»0 if left edge even 

=>check. right edge 

V=l if left edge odd 

restore WNDLFT 

get oddity of right edge 

C=l if right edge even 

if odd left, don't DEY 

if even right, don't DEY 

if right edge odd, need one less 

save window width 

N=l if 80 columns 

save N,Z,V 

assume scroll from top 

up or down? 

=>up 

down, start scrolling at bottom 

really need one less 

;get current line 

;calculate base with window width 

;current line is destination 



test direction 

=>do the downer 

do next line 

done yet? 

=>yup , all done 

set new line 

get base for new current line 

get width for scroll 

get status for scroll 

N=l if 80 columns 

=>only do 40 columns 

scroll aux page first (even bytes) 

test Y 

if Y=0, only scroll one byte 



;do all but last even byte 
;odd left edge, skip this byte 






dix I: Monitor ROM Li 






CC4E 
CC50 
CC52 
CC55 
CC57 
CC59 
CC5B 
CC5D 
CC5E 
CC60 
CC62 
CC62 
CC63 
CC65 
CC67 
CC67 
CC68 
CC69 
CC6B 
CC6E 
CC71 
CC72 
CC73 
CC74 
CC74 
CC74 
CC74 
CC77 
CC79 
CC7A 
CC7C 
CC7F 
CC82 
CC84 
CC86 
CC88 
CC8A 
CC8B 
CC8D 
CC90 
CC90 
CC90 
CC90 
CC90 
CC93 
CC96 
CC96 
CC96 
CC96 
CC98 
CC9A 
CC9A 
CC9A 
CC9A 



CC5D 



CC59 
CC23 



CC35 



Bl 28 

91 2A 
AD 54 CO 
A4 21 
BO 04 
Bl 28 
91 2A 
88 

10 F9 
30 CI 

CA 

E4 22 
10 CE 

28 
68 

85 21 
20 96 CC 

20 FE CD 
68 

AA 
60 



20 9A CC 

A5 25 

48 

10 06 CC82 

20 03 CE 

20 96 CC 

E6 25 

A5 25 

C5 23 

90 F2 

68 

85 25 

4C FE CD 



CC7C 



CC90 



20 5F CB 
4C 74 CC 



AO 00 
FO 03 



CC9D 



LDA 
STA 

SKPLFT LDA 
LDY 
BCS 

SCRLODD LDA 
STA 

SKPRT DEY 
BPL 
BMI 



DEX 
CPX 
BPL 



(BASL),Y 

(BAS2L),Y 

TXTPAGE1 

WNDWDTH 

SKPRT 

(BASL),Y 

(BAS2D.Y 

SCRLODD 
SCRLIN 



il 
S3 
B4 

as 

86 
87 

88 
89 

yo 

91 

92 * 

93 SCRLDN 
94 
95 

96 * 
97 
98 
99 

100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 X.VTLOQP JSR VTABZ 



;now do main page (odd bytes) 

;restore width 

;eve.n right edge, skip this byte 



;=> always scroll next line 



SCRLL3 



WNDTOP 
SETSRC 



WNDWDTH 

X.SUB 

VTAB 



PLP 

PLA 
STA 
JSR 
JSR 
PLA 
TAX 
RTS 



EXECUTE CLR TO EOS: 



;do next line 
;done yet 
;=>nope, not yet 

;pull status off stack 
jrestore window width 

;clear current line 

;restore original cursor line 

;and X 

;done! ! ! 



X.VT 



JSR 


X.GS 


;CLRAR TO EOL 


LDA 


CV 


;SAVE CV 


PHA 






BPL 


X.VTNEXT 


:D0 NEXT LINE 



: 13 



JSR X.SUB 



114 X.VTNEXT INC CV 



CV 

WNDBTM 

X.VTLOOP 

CV 
VTAB 



AC 7B 05 



115 LDA 

1 1 6 CMP 

117 BCC 

1 1 8 PLA 

119 STA 

120 JMF 

121 * 
122 

123 * 

124 X.FF 
125 
126 

127 * 

128 * EXECUTE CLEAR LINE 

129 * 

130 X.SUB LDY #0 

131 BEO X.GSEOL2 

132 * 

133 * EXECUTE CLEAR TO EOL: 

134 * 
135 



EXECUTE CLEAR: 



EQU * 
JSR X.EM 
JMP X.VT 



X.GS 



LDY OURCH 



;set base address 
; CLEAR LINE 



;OFF SCREEN? 

;=>N0, KEEP GOING 

; RESTORE 

; CV 

; re turn via VTAB (blech) 



;H0ME THE CURSOR 

; RETURN VIA CLREOS (UGH!) 



;start at left 

;and clear to end of line 



;get CH 



; !or ROM Listings 



335 



CC9D 


A3 


\2 




136 


X 


GSEOLZ LDA 


INVFLG 


;mask blank 


CC9F 


29 


SO 




137 






AND 


#580 


;with high bit of invflp 


CCA1 


09 


20 




138 






ORA 


#$20 


;make it a blank 


CCA3 


2C 


iF 


CO 


139 






BIT 


RDBOVID 


;ls it 80 columns? 


CCA6 


30 


L5 


CCBD 


140 






BMI 


CLR80 


;=>yes do quick clear 


CCA8 


91 


2 8 




141 


CLR40 


STA 


<BASL),Y 




CCAA 


C8 






142 






INY 






CCAB 


C4 


2] 




143 






CPY 


WNDWDTH 




CCAD 


90 


F8 


CCA8 


144 






BCC 


CLR40 




CCAF 


60 






145 






RTS 






CCBO 








146 


* 










CCBO 








147 


it 


Clear 


right half of 


screen for 40 to 80 


CCBO 








148 


* 


screen, conversion 




CCBO 








149 


* 










CCBO 


86 


2A 




150 


CLRHALF 


STX 


BAS2L 


;save X 


CCB2 


a; 


m 




151 






LDX 


#$D8 


;set horizontal counter 


CCB4 


AO 


14 




152 






LDY 


#20 




CCB6 


A5 


32 




153 






LDA 


INVFLG 


;set (inverse) blank 


CCB8 


29 


AO 




154 






AND 


#$A0 




CCBA 


AC 


DS 


CC 


155 






JMP 


CLR2 




CCBD 








156 


*■ 










CCBD 








157 


* 


Clear 


to end of line 


for 80 columns 


CCBD 








158 


* 










CCBD 


86 


2A 




159 


CLR80 


STX 


BAS2L 


;save X 


CCBF 


48 






160 






PHA 




; and blank 


GCCO 


98 






161 






TYA 




;get count for CH 


CCC1 


-,8 






162 






PHA 




;save for left edge check 


CCC2 


38 






163 






SEC 




;count=WNDWDTH-Y-l 


CCC3 


E5 


21 




164 






SBC 


WNDWDTH 




CCC5 


AA 






165 






TAX 




;save CH counter 


CCC6 


98 






166 






TYA 




;div CH by 2 for half pag 


CCC7 


4 A 






167 






LSR 


A 




CCC8 


A8 






168 






TAY 






CCC9 


68 






169 






PLA 




;restore original cb 


CCCA 


4 5 


20 




170 






EOR 


WNDLFT 


;get starting page 


CCCC 


6A 






171 






ROR 


A 




CCCD 


BO 


03 


CCD2 


172 






BCS 


CLRO 




CCCF 


10 


01 


CCD2 


173 






BPL 


CLRO 




CCD1 


C8 






174 






INY 




;iff WNDLFT odd, starting 


CCD2 


68 






175 


CLRO 


PLA 




;get blank 


CCD3 


BO 


D B 


CCEO 


176 






BCS 


CLR1 


jstarting page is 1 (defa 


CCD5 


2C 


55 


CO 


177 


CLR2 


BIT 


TXTPAGE2 


;else do page 2 


CCD8 


91 


28 




178 






STA 


(BASL).Y 




CCDA 


2C 


34 


CO 


179 






BIT 


TXTPAGE1 


;now do page 1 


CCDD 


.E8 






180 






INX 






CCDE 


FO 


06 


CCE6 


181 






8EQ 


CLR3 


;all done 


CCEO 


9 1 


28 




132 


CLR1 


STA 


(BASL),Y 




CCE2 


C8 






183 






INY 




; forward 2 columns 


CCE3 


E8 






184 






INX 




;next ch 


CCE4 


DO 


EF 


CCD5 


185 






BNE 


CLR2 


;rtot done yet 


CCE6 


A.-. 


2A 




186 


CLR3 


LDX 


BAS2L 


; res tore X 


CCE8 


38 






187 






SEC 




;good exit condition 


CCE9 


68 






188 






RTS 




;and return 


CCEA 








189 


* 

















- 



CCEA: 
CCEA: 
CCEA: 
CCEA ; AD 
CCED:30 

CD3C 
CCEF:20 
CCF2:2C 
CCF5:10 
CCF7:20 
CCFA:90 
CCFC: 
CCFC: 
CCFC: 
CCFC: 
CCFC: 20 
CCFF:D0 
CD01:2C 
CD04:30 
CD06:20 
CD09: 
CD09:AD 
CD0C:18 
CDOD:65 
CD0F:2C 
CO12:30 
CD14:C9 
CD16:90 
CD18:A9 
CD1A:8T) 
CD1D:85 
CD1F:A5 
CD21:20 
CD24:2C 
CD27:10 
CD29: 
CD29:20 
CD2C:FO 
CD2E: 
CD2E:20 
CD31:A9 
CD33:2C 
CD36:30 
CD38:A9 
CD3A:85 
CD3C:60 
CD3D: 
CD3D: 
CD3D: 
CD3D:AD 
CD40:09 
CD4 2:DO 
CD44: 
CD44: 



CCEA 
FB 04 
4D 
194 
31 CD 
IF CO 
12 CD09 
91 CD 
01) CD09 



CCFC 
90 CA 
3B CD3C 

IF CO 

03 CD09 

C4 CD 

7B 05 

20 

IF CO 

06 CDiA 



CD1A 



28 

02 

27 

7B 05 

24 

25 

BA CA 

IF CO 

05 CD2E 

71 CD 

03 CD31 

6D CD 

00 

LA CO 

02 CD3A 

14 

22 



FB 04 

01 

05 CD49 



190 * EXECUTE '40C0L MODE': 

191 * 

192 X.DC1 EQU * 

193 LDA MODE ;don'-t convert if Pascal 



BMI X.DC1RTS 
195 X.DC1A JSR 

BIT 



;=>it'e Pascal 



BPL 
JSR 
BCC 



SETTOP 

RD80VID 

X.DC1B 

SCRN84 

X.DC1B 



;set top of window (0 or 20) 
;are we In 80 columns? 
;=>no, no convert needed 
;else convert 80 to 40 
;=>always set new window 



Set 80 column mode 



DC1B 



196 
197 
198 
199 
200 
201 

202 * 

203 X.DC2 
204 
205 
206 
207 
208 
209 * 
210 
211 
212 
213 
214 
215 
216 
217 

218 X.DC1C 
219 
220 
221 
222 
223 
224 
225 
226 

227 * 

228 D040 

229 SETTOP 
230 
231 
232 

233 DO40A 

234 X.DCIRTS RTS 

235 * 

236 * EXECUTE MOUSE TRXT OFF 

237 * 

238 MOUSEOFF LDA MODE 

239 ORA #M. MOUSE ;set mouse bit 

240 BNE SMOUSE ;to disable mouse chars 

241 * 

242 * EXECUTE MOUSE TEXT ON 



DO80 



EQU 
JSR 
BNE 
BIT 
BMI 
JSR 

LDA 
CLC 

ADC 
BIT 
BMI 
CMP 
BCC 
LDA 
STA 
STA 
LDA 
JSR 
BIT 
BPL 

JSR 
BEO 

JSR 
LDA 
BIT 
BMI 
LDA 
STA 



TESTCARD 

X.DCIRTS 

RD80VID 

X.DC1B 

SCRN48 

OURCH 

WNDLFT 

RD80VID 

X.DC1C 

if' 40 

X.DC1C 

#39 

OURCH 

CH 

CV 

BASCALC 

RD80VID 

D040 

FULL80 
SETTOP 

FULL40 

#0 

RDTEXT 

DO40A 

WNDTOP 



;is there an 80 column card? 
;=>no, can't do this 
;are we in 40 columns? 
;=)no, no convert needed 
;else convert 40 to 80 

;get cursor 

;since new window left ■ 

; NEWCH=OLDCH+OLDWNDLFT 

jin 80 columns? 

;=>yes, CH is ok 

;else if CH is too big, 

;aet it to 39 

;eave new CH 



;base 

;in 80 columns? 
;=>>no, set forty 



column window 



;set 80 column window 
;=>always branch 

;set 40 column window 
;assume normal window 
;text or mixed? 
;=>text, all olc 

;set new top 






337 



CD44 
CD44 
CD47 
CD49 
CD4C 
CD4D 
CD4D 
CD4D 
CD4D 
CD4D 
CD50 
CD52 
CD55 
CD58 
CD5B 
CDSB 
CDSD 
CD5F 
CD61 
CD63 
CD64 
CD64 
CD66 
CD68 
CD6A 
CD6C 
CD6D 
CD6D 
CD6D 
CD6D 
CD6D 
C06D 
CD6D 
CD6D 
CD6D 
CD6D 
CD6D 
CD6F 
CD71 
CD71 
CD71 
CD71 
CD71 
CD71 
CD71 
CD71 
CD71 
CD71 
CD73 
CD7 5 
CD77 
CD79 
CD7B 
CD7D 



FB 04 
FE 
FB 04 



CD4D 
FB 04 
1A CD6C 
2E CD 
80 CD 
64 CD 

FD 

39 
IB 

3a 



37 
F0 
36 



28 
02 



50 
Z) 

18 
23 

00 
2 2 
20 



CD6D 
CD7 3 



243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 



MOUSEON LDA MODE 

AND 0255-M. MOUSE ;clear mouse bit 



SMOUSE STA MODE 
RTS 

* 

* EXECUTE 'QUIT' : 

* 



X.NAK 



EQU * 

LDA MODE 

BMI SKRTS 

JSR DO40 

JSR QUIT 



;to enable mouse chars 



;ONLY VALID IN BASIC 
;ignore If pascal 
;force 40 column window 
;do stuff used by PR0O 



JSR SETCOUT1 ;set output hook 
;set Input hook 



;set output hook 



SETKEYIN LDA KKEYIN 
STA KSWH 
LDA #>KEYIN 
STA KSWL 
RTS 

* 

SETC0UT1 LDA #<C0UT1 
STA CSWH 
LDA 0>COUT1 
STA CSWL 

SKRTS RTS 



**************************************** 

* NAME : FULL40 

* FUNCTION: SET FULL 40C0L WINDOW 

* INPUT : NONE 

* OUTPUT : WINDOW PARAMETERS, A=0 

* VOLATILE: AC 

**************************************** 
* 

FULL40 EQU * 

LDA #40 ;set window width to 40 
BNE SAVWDTH ;->( always taken) 

* 

**************************************** 

* NAME : FULL80 

* FUNCTION: SET FULL 80COL WINDOW 

* INPUT : NONE 

* OUTPUT : WINDOW PARAMETERS, A=0 

* VOLATILE: AC 
**************************************** 



FULLS LDA #80 

SAVWDTH STA WNDWDTH 

LDA #24 

STA WNDBTM 

LDA #0 

STA WNDTOP 

STA WNDLFT 



;set full 80 column window 



life 






tdix I: Monitor ROM Listings 



CD7F 
CD80 

CD80 

CD80 

CD80 

CD80 

CD83 

CD85 

CD88 

CD8B 

CD8D 

CD90 

CD91 

CD91 

CD91 

CD9I 

CD91 

CD91 

CD92 

CD93 

CD95 

CD98 

CD99 

CD9C 

CB9E 

CDAO 

CDA1 

CDA2 

GDA4 

CDA7 

CDA8 

CDAA 

CDAD 

CDAF 

CDB1 

CDB2 

CDB4 

CDB5 

CDB7 

CDB9 

CDBB 

CDBE 

CDC1 

CDC4 

CDC4 

CDC5 

CDC6 

CDC8 

CDC9 

CDCC 

CDCE 

CDD1 

CDD3 

CDD5 



60 



2C IF 
10 03 
20 EF 
8D OE 
A9 FF 
8D FB 
60 



8 A 

48 

A2 17 
8D 01 
8A 

20 BA 
AO 27 
84 2A 
98 
4A 

BO 03 
2C 55 
AS 

Bl 28 
2C 54 
A4 2A 
91 28 
88 

10 EA 
CA 

30 04 
E4 2 2 
BO DD 
8D 00 
8D OC 
4C F8 

3 A 
48 

A2 17 
8A 

20 BA 
AO 00 
8D 01 
Bl 28 
84 2A 
48 



CD80 



CO 

c 
cc 

CO 
04 



CD88 



CO 
CA 



CDA7 



CO 



CO 



CD9E 
CDBB 
CD98 



CO 
CO 

CD 



CA 
CO 



297 

298 

299 

300 

301 

302 

303 

304 

305 0UIT2 

306 

307 

308 

309 * 

310 

311 

312 

313 

314 

315 

316 

317 

318 

319 

320 

321 

322 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 

348 

349 

350 



RTS 

* QUIT is used by PR#0 

* 

QUIT 



to turn off everything 



EQU 
BIT 
BPL 
JSR 
STA 
LDA 
STA 
RTS 



RD80VID ;were we in 80 columns? 
QUIT2 ;=> not a chance 
X.DC1A jswitch to 40 columns 
CLRALTCHAR ; don't use lower case 
it$FT ; DESTROY THE 

MODE ; MODE BYTE 



SCRN84 and SCRN48 convert screens between 40 f, 80 cols. 
WNDTOP must be set up to indicate the last line to 
be done. All registers are trashed. 



* 

SCRN84 



SCR1 



SCR2 



SCR3 



SCR4 



SCRN48 



SCR5 



SCR6 
SCR8 



TXA 
PHA 
LDX 
STA 
TXA 
JSR 
LDY 
STY 
TYA 
LSR 
BCS 
BIT 
TAY 
LDA 
BIT 
LDY 
STA 
DEY 
BPL 
DEX 
BMI 
CPX 
BCS 
STA 
STA 
JMP 

TXA 

PHA 
LDX 
TXA 

JSR 
LDY 
STA 
LDA 
STY 
PHA 



#23 

SET80COL 

BASCALC 

#39 

BAS2L 

A 

SCR3 

TXTPAGE2 

(BASL),Y 

TXTPAGE1 

BAS2L 

(BASL).Y 

SCR2 

SCR4 

WNDTOP 

SCR1 

CLR80C0L 

CLR80VID 

SCRNRET 



#23 

BASCALC 

#0 

SET80COL 

(BASL).Y 

BAS2L 



; s ave X 

;start at bottom of screen 
;allow page 2 access 
;calc base for line 

;start at right of screen 

;save 40 index 

;div by 2 for 80 column index 



;even column, do page 2 
;get 80 index 
;get 80 char 
jrestore pagel 
;get 40 index 



;do next 40 byte 
;do next line 
;=>done with setup 
;at top yet? 

;clear 80STORE for 40 columns 
;clear 80VID for 40 columns 
;calc base, restore X, exit 



;save X 

;start at 

;set base 



bottom of screen 
for current line 



;start at left of screen 
jenable page2 store 
;get 40 column char 
;save 40 column index 
;save char 



Appendix I: Monitor ROM Listings 



■m 



CDD6:98 






351 




TYA 




;div 2 for 80 column index 


CDD7:4A 






352 




LSR 


A 




COD8:B0 


03 


CDDD 


353 




BCS 


SCR7 


;5ave on pagel 


CDDA:8D 


55 


CO 


354 




STA 


TXTPAGE2 




CDDD : A8 






355 


SCR7 


TAY 




j get 80 column Index 


CODE: 68 






356 




PLA 




;now save character 


CDDF:91 


28 




357 




STA 


(BASL),Y 




CDE1 :8D 


54 


CO 


358 




STA 


TXTPAGE1 


;flip pagel 


CDE4:A4 


2 A 




359 




LDY 


BAS2L 


;restore 40 column index 


CDE6:C8 






360 




INY 




;move to the right 


CDE7:C0 


■■>■■■ 




361 




CPY 


HO 


;at right yet? 


CDE9:90 


E6 


CDD1 


362 




BCC 


SCR6 


;=>no, do next column 


CDEB:2Q 


BO 


CC 


363 




JSR 


CLRHALF 


;clear half of screen 


CDEE:CA 






364 




DEX 




;else do next line of sere 


CDEF:30 


04 


C0F5 


365 




BMI 


SCR9 


;=>done with top line 


CDF1:E4 


22 




366 




CPX 


WNDTOP 


;at top yet? 


CDF3:B0 


D3 


C0C8 


367 




BCS 


SCR5 




CDF5:8D 


OD 


CO 


368 


SCR9 


STA 


SET80VID 


; convert to 80 columns 


CL)F8;20 


PE 


CD 


369 


SCRNRET 


JSR 


VTAB 


;update base 


CDFB:68 






370 




PLA 




^restore X 


CDFC:AA 






371 




TAX 






CDFD:60 






372 




RTS 






CDFE: 






373 


* 








CDFE:A5 


25 




374 


VTAB 


LDA 


CV 


;get 80 column CV 


CE00:8D 


FB 


05 


375 




STA 


OURCV 


;copy to OURCV 


OE03:20 


BA 


CA 


376 


VTABZ 


JSR 


BASCALC 


;calc base address 


CE06:A5 


20 




377 




LDA 


WNDLFT 


;and add window left to it 


CE08:2C 


: r 


CO 


378 




BIT 


RD80VID 


;ls it 80 columns? 


CE0B:10 


01 


CEOE 


379 




BPL 


VTAB40 


;window width ok 


CE0D:4A 






380 




LSR 


A 


;else divide width by 2 


CE0E:18 






381 


VTAB40 


CLC 




jprepare to add 


CEOF :65 


. > ; 




382 




ADC 


BASL 


;add in window left 


CE11 :85 


28 




383 




STA 


BASL 


;and update base 


CK13:60 






384 


VTABX 


RTS 




; and exi t 


CE14: 






29 




INCLUDE SUBS3 




CE14:C9 


k] 




1 


UPSHFT 


CMP 


#$E1 


;is it lowercase? 


CE16:90 


06 


CE1E 


2 




BCC 


UPSHFT2 


;=>nope 


CE18:C9 


FB 




i 




CMP 


#SFB 


; lowercase? 


CEIAjBO 


02 


CE1E 


It 




BCS 


UPSHFT2 


;=>nope 


CEIC:29 


DF 




^ 




AND 


#$DF 


;else upshift 


CE]E:60 






6 


UPSHFT2 


RTS 






CEIF: 






7 


* 








CEIF: 






B 


**************************************** 


CEIF: 






9 


* NAME 




INVERT 




CEIF: 






LO 


* FUNCTION: 


INVERT CHAR 


AT CH/CV 


CEIF: 






i I 


* 




Unless Pascal and M. CURSOR* 1 


CEIF! 






12 


* INPUT 


: 


NOTHING 




CEIF: 






13 


* OUTPUT : 


CHAR AT CH/CV INVERTED 


CEIF: 






U 


* VOLATILE: 


NOTHING 




CEIF: 






15 


* CALLS 


: 


PICK, STORCHAR 


CEIF: 






16 


**************************************** 


CEIF: 






17 


* 








CE1F:AD 


FB 


04 


18 


PASINV 


LDA 


MODE 


;check pascal cursor flag 


CE22:29 


10 




19 




AND 


#M. CURSOR 


;before displaying cursor 









CE24 


DO 


1) 




CE37 


20 




BNE 


INVX 


=>cursor off, don't invert 


CE26 


48 








2! 


INVERT 


PHA 




s ave AC 


CE27 


98 








22 




TYA 




AND Y 


CE28 


42 








23 




PHA 






CE29 


AC 


7B 


05 




24 




LDY 


OURCH 


GET CH 


CE2C 


20 


44 


CE 




22 




JSR 


PICK 


GET CHARACTER 


CE2F 


49 


80 






26 




EOR 


//gso 


FLIP INVERSE/ NORMAL 


CE31 


20 


7 


CE 




22 




JSR 


STORIT 


ONTO SCREEN 


CE34 


68 








28 




PLA 




RESTORE Y 


CE35 


A8 








2 9 




TAY 




AND AC 


CE36 


68 








30 




PLA 






CE37 


6C 








2] 


INVX 


RTS 






CE38 










2 2 


***************** ******! 


t **************** 


CE38 










23 


* NAME 




STORCHAR 




CE38 










J 4 


* FUNCTION: 


STORE A CHAI 


I ON SCREEN 


CE38 










j 5 


* INPUT 




AC=CHAR 




CE38 










36 


* 




Y=CH POSIT, 


ON 


CE38 










27 


* OUTPUT : 


CHAR ON SCRI 


JEN 


CE38 










26 


* VOLATILE: 


NOTHING 




CE38 










3 si 


* CALLS 




SCREENIT 




CE38 










22' 


***********************! 


***************** 


CE38 










41 


■k 








CE38 








CE38 


42 


STORCHAR EQl 


* 




CE38 


4a 








43 




PHA 




SAVE AC 


CE39 


24 


32 






44 




BIT 


INVFLG 


NORMAL OR INVERSE? 


CE3B 


30 


02 




CE3F 


45 




BMI 


ST0R2 


=> NORMAL 


CE3D 


29 


;f 






i6 




AND 


#$7F 


Inverse it 


CE3F 








CE3F 


47 


ST0R2 


EQU 


* 




CE3F 


2Q 


70 


CE 




46 




JSR 


STORIT 


=>do it ! I 


CE42 


68 








49 




PLA 




RESTORE AC 


CE43 


60 








50 


SEV 


RTS 






CE44 










51 


***********************^ 


***************** 


CE44 










52 


* NAME 




PICK. 




CE44 










5 2 


* FUNCTION: 


GET A CHAR 1 


'ROM SCREEN 


CE44 










54 


* INPUT 




Y=CH POSITK 


)N 


CE44 










55 


* OUTPUT : 


AC=CHARACTEf 


i 


CE44 










56 


* VOLATILE: 


NOTHING 




CE44 










57 


* CALLS 




SCREENIT 




CE44 










2a 


************************ 


***************** 


CE44 










59 


* 








CE44 


Bl 


2* 






so 


PICK 


LDA 


(BASL),Y 


get 40 column character 


CE46 


2C 


! F 


CO 




61 




BIT 


RD80V1D 


80 columns? 


CE49 


10 


19 




CE64 


o2 




BPL 


PICK3 


=>no, do text shift 


CE4B 


an 


Oi 


CO 




63 




STA 


SET80COL 


force 80STORE for 80 colum 


CE4E 


84 


2A 






64 




STY 


BAS2L 


temp store for position 


CE5n 


98 








h2 




TYA 




divide CH by two 


CE51 


45 


20 






66 




EOR 


WNDLFT 


C=l if char in main RAM 


CE53 


6A 








67 




ROR 


A 


get low bit into carry 


CE54 


BO 


54 




CE5A 


68 




BCS 


PICK1 


=>store in main memory 


CE56 


AD 


55 


CO 




69 




LDA 


TXTPAGE2 


else switch in page 2 


CE59 


C8 








70 




ore 




for odd left, aux bytes 


CE5A 


98 








71 


PICK1 


TYA 




divide position by 2 


CE5B 


4 A 








7 2 




LSR 


A 


and use carry as 


CE5C 


A8 








7 3 




TAY 




page indicator 






Monitor R\ i 



341 



CE5D 


BL 


28 






/ 4 


PICK2 


LDA (BASL),Y 


;get that char 


CE5F 


2C 


54 


CO 




75 






SIT TXTPAGE1 


;fLip to page 1 


CE62 


A4 


2 A 






76 






LDY BAS2L 




CE64 


2C 


IE 


CO 




11 


PICO 


BIT ALTCHARSET 


;only allow mouse text 


CE67 


10 


06 




CE6F 


78 






BPL PICK4 


;if alternate character set 


CE69 


C9 


10 






7 9 






CMP #$20 




CE6B 


BO 


02 




CE6F 


80 






BCS PICK4 




CE6D 


09 


40 






8] 






ORA #$40 




CE6F 


60 








82 


PICK4 


RTS 




CE70 










■63 


* 










CE70 










84 


**************** ************************ 


CE70 










85 


* 


NAME 




STORIT 




CE70 










86 


* 


FUNCTION 


STORE CHAR 




CE70 










87 


* 


INPUT 




AC=char for 


store 


CE70 










m 


ft 






Z=high bit 


of char 


CE70 










89 


* 






Y=CH POSITION 


CE70 










90 


* 


OUTPUT 


AC=CHAR (PICK) 


CE70 










91 


* 


VOLATILE 


NOTHING 




CE70 










92 


A 


CALLS 




NOTHING 




CE70 










93 


**************************************** 


CE70 










94 


* 










CE70 


48 








as 


STORIT 


p«y 


k 


;save char 


CE71 


29 


PF 






96 






ANf 


) #$FF 


;if high bit set.. . 


CE73 


30 


16 




CE8B 


97 






BM 


: STOREl 


;=>not mouse text 


CE75 


AD 


ra 


04 




9^ 






LI)/ 


k MODE 


;ls mouse text enabled? 


CE78 


6A 








99 






ROT 


t A 


;use carry as flag 


CE79 


68 








LOO 






PU 


k 


; and restore char 


CE7A 


48 








101 






PHJ 


k 


;need to save it too 


CE7B 


90 


GE 




CE8B 


102 






BC; 


: STOREl 




CE7D 


2C 


IE 


CO 




103 






Bf 


1 ALTCHARSET 


;only do mouse text if 


CE80 


10 


09 




CE8B 


104 






BP1 


, STOREl 


;aXt char set switched in 


CE82 


49 


40 






105 






EOT 


i #$40 


;do mouse shift 


CE84 


2C 


AC 


CE 




106 






an 


: hex60 


;is it in proper range? 


CE87 


FO 


2 




CE8B 


107 






BE( 


j STOREl 


;=>yes, leave it 


CE89 


49 


4 






108 






E01 


£ #$40 


;else shift It back 


CE8B 










109 


* 










CE8B 


2C 


1 K 


CO 




110 


ST0RE1 


hi: 


1 RD80VID 


;80 columns? 


CE8E 


LO 


LD 




CEAD 


lii 






EPi 


, ST0R40 


;=>no, 40 columns 


CE90 


8D 


01 


CO 




L12 






ST,- 


k SET80COL 


jforce 80STORE for 80 columns 


CE93 


■■>R 








113 






PW 


k 


;save shifted character 


CE94 


84 


2A 






114 






:-T 


BAS2L 


;temp storage 


CE96 


98 








115 






n i 


k 


;get position 


CE97 


45 


zq 






116 






EOI 


I WNDLFT 


;C=1 if char in main RAM 


CE99 


4A 








117 






LSI 


t A 




CK9A 


BO 


0-* 




CEAO 


118 






BCi 


! ST0RE2 


;=>yes, main RAM 


CE9C 


AD 


55 


CO 




119 






LW 


k TXTPAGE2 


;else flip in main RAM 


CE9F 


C8 








120 






m 


r 


;do this for odd left bytes 


CEAO 


98 








121 


ST0RE2 


m 


i. 


;get position 


CEA1 


4A 








122 






LSI 


5 A 


;and divide it by 2 


CEA2 


A8 








123 






IA1 






CEA3 


88 








124 


ST0RIT2 


VU 


k 


; restore ace 


CEA4 


91 


28 






i 25 






ST/ 


k (BASL),Y 


;save to screen 


CEA6 


AD 


54 


CO 




126 






LDi 


k TXTPAGE1 


;flip to page 1 


CEA9 


A4 


2 A 






127 






LV,\ 


BAS2L 








Appendix I; Mon I tstings 



I 
■ 



CEAB 


68 






CEAC 


60 






CEAD 








CHAD 


9 1 


28 




CEAF 


68 






CEBO 


61, 






CEB1 








CEB1 








CEB1 








CEB1 








CEB1 








CEB1 








CEB1 








CEB1 








CEB1 








CEB1 








CEB1 


4 8 






CEB2 


98 






CEB3 


48 






CEB4 


AC 


7B 


05 


CEB7 


20 


44 


OH 


CEBA 


8D 


7B 


06 


CEBD 


29 


80 




CEBF 


49 


AE 




CEC1 


40 


CD 


CE 


CEC4 








CEC4 








CEC4 








CEC4 








CEC4 








CEC4 








CEC4 








CEC4 








CEC4 








CEC4 








CEC4 


48 






CEC5 


98 






CEC6 


46 






CEC7 


AC 


7B 


05 


CECA 


M> 


7B 


06 


CECD 








CECD 


20 


70 


CE 


CEDO 


68 






CED1 


fc8 






CED2 


68 






CED3 


60 






CED4 








CED4 








CED4 








CED4 








CEDi 








CED4 








CED4 








"■:- 









CEB1 



CEC4 



CECD 



128 PLA ;restore true Ace 

129 HEX60 RTS ;and exit 

130 * 

131 ST0R40 STA (BASL),Y ;quick 40 column store 

132 PLA jrestore real char 

133 RTS 

134 **************************************** 

135 * NAME : ESCON 

136 * FUNCTION: TURN ON 'ESCAPE' CURSOR 

137 * INPUT : NONE 

138 * OUTPUT : 'CHAR'=ORIGINAL CHAR 

139 * VOLATELE: NOTHING 

140 * CALLS : P1CK.STORCHAR 

141 **************************************** 

142 * 

* 



143 ESCON 

144 

145 

146 

147 

148 

149 

150 

151 

152 



EQU 
PHA 
TYA 
PHA 
LDY 
JSR 
STA 
AND 
EOR 
JMP 



;SAVE AC 
; AND Y 

OURCH ;GET CH 

PICK ;GET ORIGINAL CHARACTER 

CHAR ; AND REMEMBER FOR ESCOFF 

#580 ;SAVE NORMAL/ INVERSE BIT 

#$AB ;MAKE IT AN INVERSE '+' 

ESCRET ; RETURN VIA SIMILAR CODE 



153 **************************************** 

154 * NAME : ESCOFF 

155 * FUNCTION: TURN OFF 'ESCAPE' CURSOR 

156 * INPUT : 'CHAR'=ORIGINAL CHAR 

157 * OUTPUT : NONE 

158 * VOLATILE: NOTHING 

159 * CALLS : STORCHAR 

15q **************************************** 

161 * 

162 ESCOFF EQU * 
PHA ;SAVE AC 
TYA ; AND Y 



163 

164 

165 

166 

167 

168 ESCRET 

169 

170 

171 

172 

173 



PHA 
LDY 
LDA 
EQU 
JSR 
PLA 
TAY 
PLA 
RTS 



OURCH 
CHAR 



STORIT 



;GET CH 

GET ORIGINAL CHARACTER 
USED BY ESCON 

EXACTLY AS IT WAS 
RESTORE Y 

AND AC 



174 **************************************** 

175 * NAME : PSETUP 

176 * FUNCTION: SETUP ZP FOR PASCAL 

177 * INPUT : NONE 

178 * OUTPUT : NONE 

179 * VOLATILE: AC 

180 * CALLS : NOTHING 

181 **************************************** 
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CED4; 
CED4: 
GED4; 
CED7; 
CED9; 
CEDE: 
CEDB: 
CEDE: 
CEEO 
CEE2: 
CEE4: 
CEE4; 
CEE4: 
CEE7 : 
CEE9; 
CEEC: 
CEEE: 
CEF1: 
CEF3! 
CEF4: 
CEF4: 
CEF4; 
CEF4: 
CEF4: 
CEF4 : 
CEF4; 
CEF4: 
CEF4 ! 
CEF7: 
CEF9: 
CEFB: 
CEFE: 
CFOO: 
CF02: 
CFQ5: 
CF07: 
CF09: 
CROC: 
CFOF: 
CF12: 
CF14: 
CF16: 
CF17: 
CF1A: 
CF1D: 
CF1F: 
CF21: 
CF23: 
CF25: 
CF27: 
CF29: 
CF2A: 
CF2C: 
CF2E: 
CF30: 
CF33: 
CF36: 



CED4 
20 71 CD 
A9 FF 
85 32 

AD FB 04 
29 04 

FO 02 CEE4 
46 32 



CEE4 



AD 7B 07 
85 28 
AD FB 07 
85 29 
AD FB 05 
85 25 
60 



2C 12 
10 3D 
A9 06 
CD B3 
FO 36 
A2 03 
2C 11 
30 02 
A2 OB 
8D B3 
2C 80 
AD B3 
C9 06 
FO 01 
E8 

2C 81 
2C 81 
AO 00 
A9 F8 
85 37 
84 36 
Bl 36 
91 36 
C8 

DO F9 
E6 37 
DO F5 
BD 80 
BD 80 
60 



CO 



CF36 



! « 



CF36 



CO 



CF09 



FB 

CO 
FB 



CF17 



CO 

CO 



CF25 
CF25 



CO 
CO 



182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 



* 
PSETUP 

IS80 



EQU 
JSR 
LDA 

STA 

LDA 
AND 
BEQ 
LSR 



FULL80 

#255 

1NVFLG 

MODE 

//M.VMODE 
PSETUFRET 
INVFLG 



;SET FULL 60COL WINDOW 
; ASSUME NORMAL MODE 



;=>IT'S NORMAL 
;MAKE IT INVERSE 



;SET UP BASE ADDRESS 



vertical 



PSETUPRET EQU * 

LDA OLDBASL 

STA BASL 

LDA OLD BASH 

STA BASH 

LDA OURCV Jget user's cursor 

STA CV ;and set It up 

RTS 
**************************************** 
* 

* COPYROM Is called when the video firmware Is 

* Initialized. If the language card is switched 

* in for reading, it copies the F8 ROM to the 

* language card and restores the state of the 

* language card. 






COPYROM BIT 
BPL 
LDA 

CMP 

BEQ 

LDX 

BIT 

BMI 

LDX 
BANK2 STA 

BIT 

LDA 

CMP 

BK0 

I NX 
WRTENBL BIT 

BIT 

LDY 

LDA 

STA 

STY 
COPYROM2 LDA <CSWL),Y 

STA (CSWL),Y 

INY 

BNE 

INC 

BNE 

LDA 

LDA 
ROMOK RTS 



RDLCRAM 

ROMOK 
//GOODF8 
F8VERSION 
ROMOK 

n 

RDLC8NK.2 

BANK2 

#$B 

F8 VERS ION 

SC08Q 

F8VERSION 

/'GOODF8 

WRTENBL 

$C081 

SC081 

#S0 

#SF8 

CSWH 

CSWL 



COPVKOM2 

CSWH 

C0PYROM2 

SCOSO.x 

$C080,x 



is the LC switched in? 

=>no, do nothing 

yes, check $F8 RAM 

does it match? 

=> assum ROM is there 

indicate bank 2, RAM write enabled 

is it bank 2? 

=>yes, we were right 

no, bank 1, RAM write enabled 

write to see if LC is 

write protected (read RAM) 

did it change? 

=>yes , write enabled 

else Indicate write protect 

read ROM, write RAM 

twice is nice 

now copy ROM to RAM 

hooks set later 

get a byte 
and move It 



;next page 
; finish copy 
;read RAM 

; done with ROM copy 






tor ROM Li 



0000: 



no no 



1 TEST 



EQU 



0000: 
0000: 
0000: 
0000: 

S 

s 
s 
s 
s 

0000: 
0000: 
0000: 
0000: 
0000: 
0000: 

0000; 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000 i 
0000; 
0000: 
0000; 
0000: 
0000: 
0000: 
0000; 
0000: 
0000; 
0000: 
0000; 
F800: 
F800: 
F800: 
F800 : 
F800; 
F800: 

F800: 

F800: 
F800: 
F800; 
F800 : 
F800: 
F800: 
F8O0: 
F800: 
F800: 
F800: 



0001 
0000 



F800 

cioo 

C300 
C800 



0001 



F800 
2000 



0000 
0001 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 



IRQTEST 



F8GRG 
10 ADR 

8 C10RG 

9 C30RG 
10 C80RG 
11 

12 F80RG 

13 CI ORG 

14 C30RG 

15 C80RG 
16 



LST 

EQU 

MSB 

DO 

EQU 

EQU 

EQU 

EQU 

EQU 

ELSE 

EQU 

EQU 

EQU 

EQU 

FIN 



On,A,V 
1 

ON 

TEST 

$1800 

$2000 

$2100 

$2 300 

$2800 

$F800 
$C100 
$C300 
SC800 



SET THEM KIBITS 



;For setting PR# hooks 



2 ******************************** 

3 * 
4 

5 

6 

7 



8 * 

9 * 
10 
11 

L2 
L3 

li 

15 

16 

17 

1 

19 

20 

21 

22 

13 

24 



APPLE II 
MONITOR II 

COPYRIGHT 1978, 

APPLE COMPUTER, 



1981, 

INC. 



1984 BY 



* ALL RIGHTS RESERVED 



S. WOZNIAK 
A. BAUM 
JOHN A 
R. AURICCHIO 
E. BEERNINK 

8 APPLE 2 E EQU 1 



1977 

1977 
NOV 1978 
SEP 1981 

1984 

;C0ND ASSM/RRA0981 



27 LOCO 



******************************** 

ORG F80RG 

OBJ S2000 
******************************* 
* 

25 * Zero Page Equates 

26 * 
S00 
$01 
520 
$21 
S22 
$23 
$24 
$25 
$26 
$27 
$28 



EQU 
EQU 
EOU 



28 LOCI 

29 WNDLFT 

30 WNDWDTH EQU 

31 WNDTOP EQU 

32 WNDBTM 

33 CH 

34 CV 

35 GBASL 

36 GBASH 

37 BASL 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



;vector for autost from disk 

;left edge of text window 
;width of text window 
;top of text window 
;bottom+l of text window 
;cursor horizontal position 
jcursor vertical position 
;lo- res graphics base addr. 

;text base address 
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F800 


: 0029 


38 BASH 


EQU 


$29 


F800 


: 002A 


39 BAS2L 


EQU 


$2A 


F800 


: 002B 


40 BAS2H 


EQU 


S2B 


F800 


: 0I12C 


41 H2 


EQU 


S2C 


F800 


: 002C 


42 LMNEM 


EOU 


$2C 


F800 


: 002D 


43 V2 


EQU 


$2D 


F800 


: 002D 


44 RMNEM 


EOU 


S2D 


F800 


: 002E 


45 MASK 


EQU 


S2E 


F800 


: 002E 


46 CHKSUM 


EQU 


S2E 


F800 


: 002 E 


47 FORMAT 


EOU 


$2E 


F800 


: 002F 


48 LASTIN 


EQU 


S2F 


F800 


: 002F 


49 LENGTH 


EQU 


$2F 


F800 


: 0030 


50 COLOR 


EQU 


$30 


F800 


: 0031 


51 MODE 


EQU 


$31 


F800 


: 0032 


52 INVFLG 


EQU 


$32 


F800 


: 0033 


53 PROMPT 


EQU 


$33 


F800 


: 0034 


54 YSAV 


EQU 


$34 


F800 


0035 


55 YSAV1 


EQU 


$35 


F800 


: 0036 


56 CSWL 


EQU 


$36 


F800 


0037 


57 CSWH 


EQU 


$37 


F800 


: 0038 


53 K.SWL 


EQU 


$38 


F800 


0039 


59 KSWH 


EQU 


$39 


F800 


003A 


60 PCL 


EOU 


$3A 


F800 


003B 


61 PCH 


EQU 


$3B 


F800 


003C 


62 AIL 


EOU 


?3C 


F800 


003D 


63 A1K 


EQU 


$3D 


F800 


003E 


64 A2L 


mv 


$3E 


F800 


003F 


65 A2H 


EQU 


$3F 


F800 


0040 


66 A3L 


EQU 


$40 


F800 


0041 


67 A3H 


EQU 


$41 


F800 


0042 


68 A4L 


EQU 


$42 


F800: 


0043 


69 A4H 


EQU 


$43 


F800 


0044 


70 A5L 


EQU 


$44 


F800: 


0044 


71 MAC STAT 


EQU 


$44 


F800: 


0045 


72 A5H 


EQU 


$45 


F800: 


0045 


73 ACC 


EQU 


$45 


F800: 


0046 


74 XREG 


EQU 


$46 


F800: 


0047 


75 YREG 


EQU 


$47 


F800: 


0048 


76 STATUS 


EQU 


$48 


F800: 


0049 


77 SPNT 


EQU 


$49 


F800: 


004E 


78 RNDL 


EQU 


$4E 


F800: 


004F 


79 RNDH 


EOU 


$4F 


F800: 




80 * 






F800: 


0095 


81 PICK 


EQU 


$95 


F800; 




82 * 






F800: 


0200 


83 IN 


EQU 


$0200 


F800: 




84 * 






F800: 




85 * Page 


3 vectors 


F800: 




86 * 






F800: 


03FO 


87 BRKV 


EQU 


$03F0 


F800: 


03F2 


88 SOFTEV 


EQU 


$03F2 


F800: 


03 F4 


89 PWREDUP 


EQU 


$03F4 


F800: 


03F5 


90 AMPERV 


EQU 


S03F5 


F800: 


03F8 


91 USRADR 


EQU 


$03F8 



(temp base for scrolling 

(temp for lo-res graphics 
(temp for mnemonic decoding 
(temp for lo-res graphics 
(temp for mnemonic decoding 
(color mask for lo-res gr. 
(temp for opcode decode 
;temp for opcode decode 
;temp for tape read caum 
;temp for opcode decode 
(color for lo-res graphics 
(Monitor mode 
; normal /inverse( /flash) 
(prompt character 
(position in Monitor command 
(temp for Y register 
(character output hook 

(character input hook 

(temp for program counter 

;A1-A5 are Monitor temps 



< 



(machine state for break 



Ace after break (destroys A5H) 

X reg after break 

Y reg after break 

P reg after break 

SP after break 

random counter low 

random counter high 



(CQNTR0L-U character 
; input buffer for GETLN 



(vectors here after break 
(vector for warm start 
(THIS MUST = EOR #$A5 OF SOFTEV+1 
(APPLESOFT & EXIT VECTOR 
(Applesoft USR function vector 






[: Monitor ROM Listings 



F800: 




03FB 


92 MI 


EQU 


$03FB ;NMI vector 


F800: 




03FE 


93 IRQLOC 


EQU 


$03FE ;Maskable interrupt vector 


F800: 






94 * 








F800 : 




0400 


95 LINE1 


EOU 


$0400 ;flrst line of text screen 


FBOO: 




07F8 


96 MS LOT 


EQU 


S07F8 jcurrent user of $C8 space 


F800: 






97 * 








F800: 




0000 


98 


DO 


TEST 




F80O: 






99 


ELSE 






FBOO: 




COOO 


100 IOADR 


EQU 


SCOOO 




F800: 






101 


FIN 






F80O: 






102 * 








F800: 




cooo 


103 KBD 


EQU 


$C000 




F800: 




C006 


104 SLOTCXROM EQU $C006 ;enable slots 1-7 


F800: 




COO 7 


105 INTCXROM EQU 


SC007 ;swap out slots for firmwai 


F800: 




C010 


106 KBDSTRB 


EQU 


SC010 




F800: 




COIF 


107 RD80VID 


EQU 


SCO IF 




F800; 




CO 20 


108 TAPEOUT 


EQU 


$C020 




F800: 




C030 


109 SFKR 


EQU 


SC030 




F80O: 




C050 


110 TXTCLR 


EQU 


SC050 




F800 




C051 


111 TXTSET 


EQU 


SC051 




F800: 




C052 


112 MIXCLR 


EQU 


SC052 




F800 




C053 


1 13 MIXSET 


EQU 


SC053 




F800 




C054 


114 LOWSCR 


EOU 


SC054 




F800 




C055 


115 HISCR 


EQU 


SC055 




F800 




C056 


116 LORES 


EQU 


?C056 




F800 




C057 


117 HIRES 


EQU 


$C057 




F800 




C058 


118 SETANO 


EOU 


$C058 




F800 




C059 


119 CLRANO 


EQU 


$C059 




F8O0 




C05A 


120 SETAN1 


EQU 


SC05A 




F800 




C05B 


121 CLEAN 1 


EOU 


$C05B 




F800 




C05C 


122 SETAN2 


EQU 


$C05C 




F800 




C05D 


123 CLRAN2 


EQU 


SC05D 




F800 




C05E 


124 SETAN3 


EQU 


5C05E 




F800 




C05F 


125 CLRAN3 


EQU 


$C05F 




F800 




C060 


126 TAPEIN 


EQU 


$C060 




F8QO 




C064 


127 PADDLO 


EQU 


SCO 64 




F800 




C070 


128 PTRIG 


EQU 


SC070 




F8O0 






129 * 








F800 




C3FA 


130 IRQ 


EQU 


C30RG+SFA ;IRQ entry In $C3 page 


F80O 




C47C 


131 IRQFIX 


EQU 


C30RG+$17C ; 


Restore state at IRQ 


F800 






132 * 








F800 




C567 


133 XKEADER 


EQU 


C30RG+$267 




F800 




C5D1 


134 XREAD 


EQU 


C30RG+$2D1 




F800 




C5AA 


135 WRITE2 


EQU 


C30RG+$2AA 




F800 






136 * 








FBOO 




CFFF 


137 CLRROM 


EQU 


SCFFF 




F8O0 




EOOO 


138 BASIC 


EQU 


5E000 




F800 




E003 


139 BASIC2 


EQU 


SE003 




F800 






140 * 








F800 


•A A 




141 PLOT 


LSR 


A 


Y-COORD/2 


F801 


:D8 




142 


PHP 




SAVE LSB IN CARRY 


F802 


:20 47 


F8 


143 


JSR 


GBASCALC 


CALC BASE ADR IN GBASL.H 


F805 


:28 




144 


PLP 




RESTORE LSB FROM CARRY 


F806 


:A9 OF 




145 


LDA 


#S0F 


MASK $0F IF EVEN 
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F808 
F80A 
F80C 
F80E 
F810 
F812 
F814 
F816 
F818 
F819 
F819 
F81C 
F81E 
F820 
F821 
F824 
F826 
F828 
F829 
F82C 
F82D 
F82F 
F831 
F832 
F832 
F834 
F836 
F838 
F83A 
F83A 
F83C 
F83E 
F840 
F843 
F844 
F846 
F847 
F847 
F848 
F849 
F84B 
F84D 
F84F 
F850 
F852 
F854 
F856 
FS58 
F859 
F35A 
F85C 
F85E 
F85F 
F85F 



90 
69 
85 
Bl 
45 
25 
51 
91 
60 

20 
C4 

BO 
Co 
20 
90 
69 
id 
20 
68 
C5 
90 
60 

AO 
DO 
AO 
84 

AO 
A9 
Si 
20 
86 
10 
60 

4 ■■■■. 
29 
09 

86 
hi 
29 

9:1 

69 

*3 
OA 
OA 
05 
85 
60 



F80C 



02 

EG 
2E 
26 

30 
26 
26 
2 6 



00 F8 

2C 

LI F831 

OE F8 

F6 F81C 

01 

00 F8 

2D 

F5 F82 6 



03 
04 

2 7 

L8 

2 
7F 
26 



26 

2 6 



F838 



2F 
C2 
27 
ZB 

27 

i'0 
30 
28 F8 



F6 F83C 



F856 



A5 30 



146 BCC 

1 4 7 ADC 

148 RTMASK STA 

149 PL0T1 LDA 

150 EOR 

151 AND 

152 EOR 

153 STA 

154 RTS 

155 * 

156 KLINE JSR 

157 HLINE1 CPY 

158 BCS 

159 I NY 

160 JSR 

161 BCC 

162 VLINE2 ADC 

163 VLINE PHA 

164 JSR 

165 PLA 

166 CMP 

167 BCC 

168 RTS1 RTS 

169 * 

170 CLRSCR LDY 

1 7 1 BNE 

172 CLRTOP LDY 

173 CLRSC2 STY 

174 ; 

17 5 LDY 

176 CLRSC3 LDA 

177 STA 

178 JSR 

179 DEY 

180 BPL 

181 RTS 

182 * 

183 GBASCALC PHA 

184 LSR 

185 AND 

186 ORA 

187 STA 

188 PLA 

189 AND 

190 BCC 

191 ADC 

192 GBCALC STA 

193 ASL 

194 ASL 

195 ORA 

196 STA 

197 RTS 

198 * 

199 NXTCOL LDA 



RTMASK 

#SEO 

MASK 

(GBASL), Y 

COLOR 

MASK 

( GBASL ),Y 

(GBASL) ,Y 



PLOT 

H2 

RTS1 

PL0T1 

HLINE1 

#$01 



PLOT 



V2 
VLINEZ 



#$2F 
CLRSC2 
#327 
V2 

#$27 
#$00 
COLOR 
VLINE 

CLRSC3 



A 

#$03 

#$04 

GBASH 

#$18 

GBCALC 

#$7F 

GBASL 

A 

A 

GBASL 

GBASL 



COLOR 



;MASK $F0 IF ODD 

;DATA 

; XOR COLOR 
; AND MASK 
; XOR DATA 
; TO DATA 



PLOT SQUARE 
DONE? 

YES, RETURN 

NO, INCR INDEX (X-COORD) 
PLOT NEXT SQUARE 
ALWAYS TAKEN 
NEXT Y-COORD 

SAVE ON STACK 

PLOT SQUARE 

DONE? 

NO, LOOP. 



;MAX Y, FULL SCRN CLR 
; ALWAYS TAKEN 
;MAX Y, TOP SCRN CLR 
; STORE AS BOTTOM COORD 
FOR VLINE CALLS 
; RIGHTMOST X-COORD (COLUMN) 
;T0P COORD FOR VLINE CALLS 
; CLEAR COLOR (BLACK) 
;DRAW VLINE 

;NEXT LEFTMOST X-COORD 
;LOOP UNTIL DONE. 



;F0R INPUT OODEFGH 

jGENERATE GBASH=000001FG 
;AND GBASL=HDEDEO0O 






; INCREMENT COLOR BY 3 






■ -oof ROM Li 



F86I 
F862 
F864 
F866 
F868 
F869 
F86A 
F86B 
F86C 
F86E 
F870 
F871 
F871 
F87 2 
F873 
F87 6 
F878 
F87 9 
F87B 
F87C 
FB7D 
FB7E 
F87F 
F881 
F882 
F882 
F884 
F886 
F889 
F88C 
F88E 
F88F 
F890 
F892 
F893 
F895 
F897 
F899 
F89B 
F89C 
F89D 
F8A0 
F8A3 
F8A5 
F8A7 
F8A9 
F8AA 
F8AD 
F8AF 
F8AF 
F8A.F 
F8AF 
-• ; -.- 
F8AF 



F8 



18 
69 03 

29 OF 
85 30 
OA 
'"A 
ft 
OA 

05 30 
85 30 
60 

08 

20 47 
Bl 26 
28 

90 04 
4A 
4 A 
4A 

4A 
29 OF 

60 



A6 3A 

A4 3B 

20 96 FD 

20 48 F9 

Al 3A 

A8 

4A 

90 09 

6A 

BO LO 

C9 A2 

FO OC 

2 9 87 

4A 

AA 

BD 62 F9 

20 79 F8 

DO 04 

AO 80 

A9 00 

AA 

BD A6 F9 

85 2E 



F87F 



F89B 



F8A5 



F8A5 



F8A9 



200 

201 

202 

203 

204 

205 

206 

207 

208 

209 

210 

211 

212 

213 

214 

215 

216 

217 

218 

219 

220 

221 

222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 

251 

252 

253 



SETCOL 



CLC 

ADC #$03 

AND #SOF 

STA COLOR 

ASL A 



;SETS C0LQR=17*A MOD 16 

;BOTH HALF BYTES OF COLOR EQUAL 



ASL 
ASL 
ASL 



SCRN 



SCRN2 



RTMSKZ 



INSDS1 



INSDS2 



IEVEN 



ERR 
GETFMT 

; (0=1 

* Move 

* that 

* the 



ORA COLOR 

STA COLOR 
RTS 

LSR A 

PHP 

JSR GBASCALC 

LDA (GBASL).Y 

PLP 

BCC RTMSKZ 

LSR A 

LSR A 

LSR A 

LSR A 

AND if$0F 

RTS 



LDX 

LOY 
JSR 
JSR 

LDA 

TAY 
LSR 
BCC 
ROR 
SCS 
CMP 
BEO 
AND 
LSR 
TAX 
LDA 
JSR 
BNE 
LDY 
LDA 
TAX 
LDA 
STA 
BYTE, 



PCL 

PCH 

PRYX2 

PRBLNK 

(PCL.X) 

A 

IEVEN 

A 

ERR 

#$A2 

ERR 

#$87 

A 

FMT1.X 
SCRN2 

GETFMT 

#$80 

#500 

FMT2.X 
FORMAT 
1=2 BYTE, 



READ SCREEN Y-COORD/2 
SAVE LSR (CARRY) 
CALC BASE ADDRESS 
GET BYTE 

RESTORE LSB FROM CARRY 
IF EVEN, USE LO H 



; SHIFT HIGH HALF BYTE DOWN 
;MASK 4-BITS 



; PRINT PCL,H 



; FOLLOWED BY A BLANK 
j GET OPCODE 

; EVEN/ ODD TEST 

;BIT 1 TEST 
;XXXXXX11 INVALID OP 

; OPCODE $89 INVALID 

;MASK BITS 

;LSB INTO CARRY FOR L/R TEST 

;GET FORMAT INDEX BYTE 
;R/L H-BYTE ON CARRY 

; SUBSTITUTE $80 FOR INVALID OPS 
;SET PRINT FORMAT INDEX TO 

; INDEX INTO PRINT FORMAT TABLE 
;SAVE FOR ADR FIELD FORMATTING 
2=3 BYTE) 



code to C1-C2 because the code 
tests for ROM In slot 3 must be in 
F8 ROM. 



Monitor ROM Li: 



'149 



F8AF 
F8B0 

F8B2 
F8B4 

F8B7 

F8B7 

F8B7 

F8B7 

F8B7 

F8B7 

F8B7 

F8B7 

F8BA: 

F8BC: 

F8BF: 

F8C2: 

F8C4: 

F8C5: 

F8C6: 

F8C8! 

F8C9; 

F8CB1 

F8CE: 

F8CF: 

F8CF: 

F8D0: 

F8D0 : 

F8D3: 

F8D4: 

F8D6: 

F8D9: 

F8DB: 

F8DE: 

F8E0: 

F8E1: 

F8E3: 

F8E5: 

F8E7: 

F8E9: 

F8EA: 

F8EB: 

F8EE: 

F8F0: 

F8F3: 

F8F5: 

F8F7: 

F8F9: 

F8FB: 

F8FD: 

F8FE: 

F8FF: 

F901: 

F903: 

F906 



:AA 

:84 2A 
:A0 10 

:4C B4 



FB 



:8D 06 
:A2 02 
:BD 05 
:DD 9C 
:D0 07 
:CA 
:CA 
:10 F4 
:88 

;D0 EF 
:8D 07 
:60 

:EA 

:20 82 
;48 

:B1 3A 
:20 DA 
:A2 01 
:20 4A 
:C4 2F 
:C8 

:90 Fl 
iA2 03 
:C0 04 
90 F2 
68 
A8 

B9 CO 
85 2C 
B9 00 
85 2D 
A9 00 
AO 05 
06 2D 
26 2C 
2A 
88 

DO F8 
69 BF 
20 ED 



CO 
C3 

re 



F8CB 

F8BC 
F8BA 



CO 
F8 
F9 



F8D4 



F8DB 



?9 

FA 



F8F9 



FD 



CA 



254 

255 

256 

257 

258 

259 

260 

261 

262 

263 

264 

265 

266 

267 

268 

269 

270 

271 

272 

273 

274 

275 

276 

277 

278 

279 

280 

281 

282 

283 

284 

285 

286 

287 

288 

289 

290 

291 

292 

293 

294 

295 

296 

297 

298 

299 

300 

301 

302 

303 

304 

305 

306 

307 



TAX 




;save ACC in X 


STY 


BAS2L 


;and Y in scrolling temp 


LDY 


#$1Q 


;call = finish mnemonics 


JMP 


GOTOCX 


;off to C100 



* Test slot 3 for a card containing ROM. 

* If there is one, we'll not switch in our 

* slot 3 firmware (for 80 columns). 

* On entry Y has a high value like $F2 , so 

* ROM/bus is read a bunch of times 
* 

SLOTCXROM 

n 

$C305,X 

CLREOL.X 
XTST 



internal 



the 



T STROM ST A 

TSTROMO LDX 

TSTROM1 LDA 

CMP 

BNE 

DEX 

DEX 

BPL 

DEY 

BNE 

XTST STA 

RTS 

NOP 

INSTDSP JSR 
PHA 

PRNTOP LDA 
JSR 
LDX 

PRNTBL JSR 
CPY 
INY 
BCC 
LDX 
CPY 
BCC 
PLA 
TAY 
LDA 
STA 
LDA 
STA 

PRMN1 LDA 
LDY 

PRMN2 ASL 
ROL 
ROL 
DEY 
BNE 
ADC 
JSR 
DEX 



;swap in slots 

;check 2 ID bytes 

;at C305 and SC307 

;with two bytes that are same 



TSTROM1 

TSTROMO 
INTCXROM 



INSDS1 

(PCL),V 

PRBYTE 
#$01 
PRBL2 
LENGTH 

PRNTOP 

#$03 

#$04 

PRNTBL 



MNEML.Y 

LMNEM 

MNEMR.Y 

RMNEM 

#$00 

#$05 

RMNEM 

LMNEM 

A 

PRMN2 

#$BF 

COUT 



; check next ID byte 



;if ROM ok, exit with BEQ 
;swap internal ROM 
; and return there 

;line things up 

;GEN FMT, LEN BYTES 

;SAVE MNEMONIC TABLE INDEX 



; PRINT 2 BLANKS 

; PRINT INST (1-3 BYTES) 
;IN A 12 CUR FIELD 

;CHAR COUNT FOR MNEMONIC INDEX 



; RECOVER MNEMONIC INDEX 



; FETCH 3 -CHAR MNEMONIC 
; (PACKED INTO 2-BYTES) 



; SHIFT 5 BITS OF CHARACTER INTO A 
; (CLEARS CARRY) 



;ADD "?" OFFSET 

; OUTPUT A CHAR OF MNEM 



I 

■■;,(■;.!; 









F9Q7: 


DO 


EC 




F8F5 


308 




BNE 


PRMN1 




F909: 


20 


48 


F9 




309 




JSR 


PRBLNK 


; OUTPUT 3 BLANKS 


F90C 


Ai 


2F 






310 




LDY 


LENGTH 




F90E: 


A2 


06 






311 




LDX 


#$06 


;CNT FOR 6 FORMAT BITS 


F910- 


Efl 


3 






312 


PRADP1 


CPX 


#$03 




F912: 


FO 


LC 




F930 


313 




BEQ 


PRADR5 


;IF X=3 THEN ADDR. 


F914- 


06 


2E 






314 


PRADR2 


ASL 


FORMAT 




F91S 


90 


OK 




F926 


315 




BCC 


PRADR3 




F918 


BD 


S3 


F9 




316 




LDA 


CHAR1-1,X 




F91B 


20 


00 


FO 




317 




JSR 


COUT 




F91E 


BD 


B9 


F9 




318 




LDA 


CHAR2-1,X 




F921: 


FO 


03 




F926 


319 




BEO 


PRADR3 




F923 


2 


ED 


FD 




320 




JSR 


COUT 




F926 


CA 








321 


PRADR3 


DEX 






F927 


DO 


a 




F910 


322 




BNE 


PRADR1 




F929 


60 








323 




RTS 






F92A 


8* 








324 


PRADR4 


DEY 






F92B 


30 


F7 




F914 


325 




BMI 


PRADR2 




F92D 


20 


DA 


Ft 




326 




JSR 


PR BYTE 




F930 


AS 


26 






327 


PRADR5 


LDA 


FORMAT 




F932 


C9 


E8 






328 




CMP 


#$E8 


; HANDLE REL ADR MODE 


F934 


SI 


3 A 






329 




LDA 


(PCL),Y 


; SPECIAL (PRINT TARGET, 


F936 


-jo 


F? 




F92A 


330 




BCC 


PRADR4 


; NOT OFFSET) 


F938 


20 


56 


F9 




331 


RELADR 


JSR 


PCADJ3 




F93B 


AA 








332 




TAX 




;PCL,PCH+OFFSET+l TO A,Y 


F93C 


E8 








333 




INX 






F93D 


DO 


01 




F940 


334 




BNE 


PRNTYX 


;+l TO Y,X 


F93F 


C8 








335 




INY 






F940 


98 








336 


PRNTYX 


TYA 






F941 


20 


DA 


PI 




337 


PRNTAX 


JSR 


PRBYTE 


; OUTPUT TARGET ADR 


F944 


8A 








338 


PRNTX 


TXA 




; OF BRANCH AND RETURN 


F945 


4C 


OA 


FT 




339 




JMP 


PRBYTE 




F948 










340 


* 








F948 


A2 


03 






343 


PRBLNK 


LDX 


#503 


; BLANK COUNT 


F94A 


A9 


AO 






342 


PRBL2 


LDA 


#SA0 


;LOAD A SPACE 


F94C 


:20 


EB 


FI 




343 


PRBL3 


JSR 


COUT 


; OUT PUT A BLANK 


F94F 


:CA 








344 




DEX 






F950 


:D0 


F8 




F94A 


345 




BNE 


PRBL2 


;LOOP UNTIL COUNT=0 


F952 


;60 








346 




RTS 






F953 










347 


* 








F953 


:38 








348 


PCADJ 


SEC 




;0=1 BYTE, 1=2 BYTE, 


F954 


A5 


2F 






349 


PCADJ2 


LDA 


LENGTH 


; 2=3 BYTE 


F956 


:A4 


3B 






350 


PCADJ3 


LDY 


PCH 




F958 


AA 








351 




TAX 




;TEST DISPLACEMENT SIGN 


F959 


:10 


1 




F95C 


352 




BPL 


PCADJ4 


; (FOR REL BRANCH) 


F95B 


:88 








353 




DEY 




;EXTEND NEG BY DECR PCH 


F95C 


:65 


3 A 






354 


PC AD J 4 


ADC 


PCL 




F95E 


:90 


0] 




F961 


355 




BCC 


RTS2 


;PCL+LENGTH(OR DISPL)+1 


F960 


:C8 








356 




INY 




; CARRY INTO Y (PCH) 


F961 


:60 








357 


RTS2 


RTS 






F962 










358 


; 








F962 










359 


; FMTl 


BYTES 


: XXXXXXYO INSTRS 


F962 










360 


; IF Y= 





THEN 


LEFT HALF BYTE 


F962 










361 


; IF Y= 


I 


THEN 


RIGHT HALF BYTE 



Monitor ROM Listings 



35] 



F962: 


362 ; 






(X=INDEX) 


F962: 


363 ; 








F962:04 


364 FMT1 


DFB 


$04 




F963:20 


365 


DFB 


$20 




F964:54 


366 


DFB 


$54 




F965:30 


367 


DFB 


$30 




F966:0D 


368 


DFB 


SOD 




F967:80 


369 


DFB 


$80 




F968:04 


370 


DFB 


$04 




F969:90 


371 


DFB 


$90 




F96A:03 


372 


DFB 


$03 




F96B:22 


373 


DFB 


$22 




F96C:54 


374 


DFB 


S54 




F96D:33 


375 


DFB 


$33 




F96E:0D 


376 


DFB 


$0D 




F96F:80 


377 


DFB 


$80 




F970:04 


378 


DFB 


$04 




F971:90 


379 


DFB 


$90 




F972:04 


380 


DFB 


S04 




F973:20 


381 


DFB 


$20 




F974:54 


382 


DFB 


S54 




F975:33 


383 


DFB 


$33 




F976;0D 


384 


DFB 


$0D 




F977:80 


385 


DFB 


$80 




F978:04 


386 


DFB 


$04 




F979:90 


387 


DFB 


$90 




F97A:04 


388 


DFB 


$04 




F97B:20 


339 


DFB 


$20 




F97C:54 


390 


DFB 


$54 




F97D:3B 


391 


DFB 


$3B 




F97E.-OD 


392 


DFB 


$0D 




F97F:80 


393 


DFB 


$80 




F980:04 


394 


DFB 


$04 




F981 :90 


395 


DFB 


$90 




F982:00 


396 


DFB 


$00 




F983:22 


397 


DFB 


$22 




F984:44 


398 


DFB 


$44 




F9B5:33 


399 


DFB 


$33 




F986:0D 


400 


DFB 


SOD 




F987 :C8 


401 


DFB 


$C8 




F988;44 


402 


DFB 


$44 




F989:00 


403 


DFB 


$00 




F9RA;11 


404 


DFB 


$11 




F98B:22 


405 


PFB 


$22 




F98C:44 


406 


DFB 


$44 




F98D:33 


407 


DFB 


$33 




F98E:0D 


408 


DFB 


$0D 




F98F:C8 


409 


DFB 


$G8 




F990:44 


410 


DFB 


$44 




F991:A9 


411 


DFB 


$A9 




F992:0t 


412 


DFB 


$01 




F993:22 


413 


DFB 


$22 




F994 :44 


414 


DFB 


$44 




F995:33 


415 


DFB 


$33 








F996:0D 


416 


DFB 


$0D 




F997:80 


417 


DPB 


$80 




F998:04 


418 


DFB 


$04 




F999:90 


419 


DFB 


$90 




F99A:0i 


420 


DFB 


$01 




F99B:22 


421 


DFB 


$22 




F99C:44 


422 


DFB 


$44 




F99D:33 


423 


DFB 


$33 




F99S:OD 


424 


DFB 


SOD 




F99F:80 


425 


DFB 


$80 




F9A0:04 


426 


DFB 


$04 




F9A1 :90 


427 


DFB 


$90 




F9A2:26 


428 


DFB 


$26 




F9A3:31 


429 


DFB 


$31 




F9A4:87 


430 


DFB 


$87 




F9A5:9A 


431 


DFB 


$9A 




F9A6: 


432 ; 








F9A6: 


433 ; Z2XXXYQ1 INSTR'S 




F9A6: 


434 ; 








F9A6:00 


435 FMT2 


DFB 


SOO 


;ERR 


F9A7:2L 


436 


DFB 


$21 


IMM 


F9A8:81 


437 


DFB 


$81 


;Z-PAGE 


F9A9:82 


438 


DFB 


S82 


ABS 


F9AA:00 


439 


DFB 


$00 


; IMPLIED 


F9AB:00 


440 


DFB 


$00 


ACCUMULATOR 


F9AC:59 


441 


DFB 


$59 


;(ZPAG,X) 


F9AD : 4D 


442 


DFB 


$4D 


(ZPAG),Y 


F9AE:91 


443 


DFB 


$91 


;ZPAG,X 


F9AF:92 


444 


DFB 


$92 


ABS.X 


F9B0:86 


445 


DFB 


$86 


,ABS,Y 


F9B1:4A 


446 


DFB 


$4A 


(ABS) 


F9B2:85 


447 


DFB 


$85 


ZPAG.Y 


F9B3:9D 


448 


DFB 


$9D 


RELATIVE 


F9B4:AC 


449 CHAR1 


DFB 


$AC 




F9B5:A9 


450 


DFB 


$A9 


')' 


F9B6:AC 


451 


DFB 


$AC 


t 


F9B7:A3 


452 


DFB 


$A3 


'#' 


F9B8:A8 


453 


DFB 


$A8 


'(' 


F9B9:A4 


454 


DFB 


$A4 ; 


'S' 


F9BA:D9 


455 CHAR2 


DFB 


$D9 


'¥' 


F9BB:00 


456 


DFB 


$00 




F9BC;D8 


457 


DFB 


$D8 


ly. 


F9BD:A4 


458 


DFB 


$A4 ; 


'$< 


F9BE:A4 


459 


DFB 


$A4 


'$' 


F9BF:00 


460 


DFB 


$00 




F9C0:1C 


461 MNEML 


DFB 


$1C 




F9C1:8A 


462 


DFB 


$8A 




F9C2:1C 


463 


DFB 


$1C 




F9C3:23 


464 


DFB 


$23 




F9C4:5D 


465 


DFB 


$5D 




F9C5:8B 


466 


DFB 


$8B 




F9C6:2B 


467 


DFB 


SIB 




F9C7:A1 


468 


DFB 


$A1 




F9C8:9D 


469 


DFB 


$9D 














F9C9 


8 A 


470 


DFB 


$8A 




F9CA: 


LD 


471 


DFB 


SID 




F9CB 


23 


472 


DFB 


§23 




F9CC: 


9D 


473 


DFB 


S9D 




F9CD 


8 3 


474 


DFB 


$8B 




F9CE: 


in 


475 


DFB 


SID 




F9CF 


a: 


476 


DFB 


SA1 




F9D0: 


00 


477 


DFB 


$00 




F9D1 


29 


478 


DFB 


S29 




F9D2 


i9 


479 


DFB 


$19 




F9D3 


ah: 


480 


DFB 


$AE 




F9D4 


b'i 


481 


DFB 


$69 




F9D5 


a-; 


482 


DFB 


$A8 




F9D6 


L9 


483 


DFB 


$19 




F9D7 


23 


484 


DFB 


S23 




F9D8 


24 


485 


DFB 


$24 




F9D9 


53 


486 


DFB 


$53 




F9DA 


IB 


487 


DFB 


SIB 




F9PB 


23 


488 


DFB 


$23 




F9DC 


24 


489 


DFB 


$24 




F9DD 


33 


490 


DFB 


$53 




F9DE 


19 


491 


DFB 


$19 


; (A) FORMAT 


F9DF 


A.L 


492 


DFB 


SAi 




F9E0 


00 


493 


DFB 


$00 




F9E1 


1 A 


494 


DFB 


$1A 




F9E2 


5B 


495 


DFB 


$5B 




F9K3 


5B 


496 


DFB 


$5B 




F9E4 


A3 


497 


DFB 


$A5 




F9E5 


69 


498 


DFB 


$69 




F9E6 


24 


499 


DFB 


$24 


; (B) FORMAT 


F9E7 


24 


500 


DFB 


$24 




F9E3 


a:. 


501 


DFB 


$AE 




F9E9 


AF. 


502 


DFB 


$AE 




F9EA 


AS 


503 


DFB 


$A8 




F9EB 


AD 


504 


DFB 


SAD 




F9EC 


29 


505 


DFB 


$29 




F9ED 


00 


506 


DFB 


$00 




F9EE 


7C 


507 


DFB 


$7C 


; CO FORMAT 


F9EF 


:00 


508 


DFB 


$00 




F9F0 


15 


509 


DFB 


$15 




F9F1 


:9C 


510 


DFB 


$9C 




F9F2 


:6D 


511 


DFB 


$6D 




F9F3 


:9C 


512 


DFB 


$9C 




F9F4 


A3 


513 


DFB 


$A5 




F9F5 


:69 


514 


DFB 


$69 




F9F6 


.29 


515 


DFB 


$29 


; (D) FORMAT 


F9F7 


:53 


516 


DFB 


$53 




F9F8 


84 


517 


DFB 


$84 




F9F9 


:I3 


518 


DFB 


$13 




F9FA 


34 


519 


DFB 


$34 




F9FB 


:1 1 


520 


DFB 


$11 




F9FC 


: A5 


521 


DFB 


$A5 




F9FD 


:69 


522 


DFB 


$69 




F9FE 


:23 


523 


DFB 


$23 


; (E) FORMAT 



! 



1 



F9FF:A0 


5 24 


DFB 


SAO 




FAOO : D8 


52 5 MNEMR 


DFB 


SD8 




FA01 :62 


526 


DFB 


$62 




FA02:5A 


527 


DFB 


$5A 




FA03:48 


528 


DFB 


$48 




FA04:26 


529 


DFB 


$26 




FA05:62 


530 


DFB 


$62 




FA06:94 


531 


DFB 


$94 




FA07:88 


532 


DFB 


$88 




FA08:54 


533 


DFB 


$54 




FA09:44 


534 


DFB 


$44 




FA0A:C8 


535 


DFB 


$C8 




FA0B:54 


536 


DFB 


$54 




FAOC : 68 


537 


DFB 


$68 




FAOD:44 


538 


DFB 


$44 




FAOE : E8 


539 


DFB 


$E8 




FAOF:94 


540 


DFB 


$94 




FA10:00 


541 


DFB 


$00 




FA1 1 : B4 


542 


DFB 


$B4 




FA12:08 


543 


DFB 


$08 




FA13:84 


544 


DFB 


$84 




FA1 4:74 


545 


DFB 


$74 




FA1 5 : B4 


546 


DFB 


$B4 




FA16:28 


547 


DFB 


$28 




FA17:6F. 


548 


DFB 


$6E 




FA18:74 


549 


DFB 


$74 




FA19:F4 


550 


DFB 


$F4 




FA1A:CC 


551 


DFB 


$CC 




FA1 B : 4A 


552 


DFB 


$4A 




FA1C:72 


553 


DFB 


$72 




FA1D:F2 


554 


DFB 


$F2 




FA1E:A4 


555 


DFB 


$A4 


; (A) FORMAT 


FA1F:8A 


556 


DFB 


$8A 




FA20:00 


557 


DFB 


$00 




FA2 1 : AA 


558 


DFB 


SA4 




FA22:A2 


559 


DFB 


$A2 




FA23:A2 


560 


DFB 


SA2 




FA24:74 


561 


npB 


S74 




FA25:74 


562 


DFB 


$74 




FA26:74 


563 


DFB 


$74 


; (B) FORMAT 


FA27;72 


564 


DFB 


572 




FA28:44 


565 


DFB 


$44 




FA29:68 


566 


DFB 


$68 




FA2A:B2 










567 


DFB $B2 








FA23:32 


568 


DFB 


$32 




FA2C:B2 


569 


DFB 


$B2 




FA2D:00 


570 


DFB 


$00 




FAI£ ;i. 


571 


DFB 


$22 


; (C) FORMAT 


fa:?: : " 


572 


DFB 


$00 




FA30:lA 


573 


DFB 


$1A 




FA3 1 : : A 


574 


DFB 


$1A 




FA32 : 26 


575 


DFB 


$26 




FA33::b 


576 


DFB 


$26 











FA34:72 






577 




DFB 


S72 


FA35:72 






578 




DFB 


$72 


F A3 6: 88 






579 




DFB 


588 


FA37:C8 






580 




DFB 


SC8 


FA38:Ci 






581 




DFB 


$C4 


FA39:CA 






582 




DFB 


$CA 


FA3A:26 






583 




DFB 


$26 


FA3B:48 






584 




DFB 


$48 


FA3C:44 






585 




DFB 


S44 


FA3D:44 






586 




DFB 


$44 


FA3E:A2 






587 




DFB 


$A2 


FA3F:C8 






588 




DFB 


$C8 


FA4Q: 






589 


* 






FA40: 




C3FA 


590 


NEW IRQ 


EQU 


SC3FA 


FA4Q: 






591 


A 






FA40:85 


43 




592 


OLDIRQ 


STA 


$45 


FA42:A5 


4 5 




593 




LDA 


$45 


FA44:4C 


FA 


C3 


594 




JHP 


NEWIRQ 


FA47: 






595 


* 






FA4 7:8D 


06 


CO 


596 


NEWBREAK STA 


SETSLOTC 


FA4A:8 5 


i r > 




597 




STA 


ACC 


FA4C: 






598 


* 






FA4C:28 






599 


BREAK 


PLP 




FA4D:20 


if 


FF 


600 




JSR 


SAV1 


FA50:6S 






601 




PLA 




FA51:85 


u 




602 




STA 


PCL 


FA33:68 






603 




PLA 




FA54:85 


3 8 




604 




STA 


PCH 


FA56:6C 


FO 


03 


605 




JMP 


(BRKV) 


FA59: 






606 


+ 






FA59:20 


82 


F8 


607 


OLDBRK 


JSR 


INSDS1 


FA5C:20 


DA 


PA 


608 




JSR 


RGDSP1 


FA5F:4C 


-A 


FF 


609 




JMP 


MON 


FA62:D8 






610 


RESET 


CLD 




FA63:20 


B4 


FE 


611 




JSR 


SETNORM 


FA66:20 


2F 


FB 


612 




JSR 


INIT 


FA69:20 


9'; 


FE 


613 




JSR 


SETVID 


FA6C:20 


69 


PE 


614 




JSR 


SETKBD 


FA6F:AD 


58 


C!t 


615 


INITAN 


LDA 


SETANO 


FA72:AD 


5 A 


CO 


616 




LDA 


SETAN1 


FA75-.AO 


09 




617 




LDY 


m 


FA77:20 


64 


VP 


618 




JSR 


GOTOCX 


FA7A.-EA 






619 




NOP 




FA7B:AD 


re 


GF 


620 




LDA 


CLRROM 


FA7E:2C 


10 


CO 


621 




BIT 


KBDSTRB 


FA81:D8 






622 


NEWMON 


CLD 




FA82:20 


3A 


FF 


623 




JSR 


BELL 


FA85:AD 


F3 


03 


624 




LDA 


SOFTEV+1 


FA88:49 


A^ 




62 5 




EOR 


#$A5 


FA8A:CD 


F4 


03 


626 




CMP 


PWREDUP 


FA8D:DQ 


17 


FM6 


627 




BNE 


PWRUP 


FA8F ; AD 


; r ;: 


03 


628 




LDA 


SOFTEV 


FA92:D0 


DP 


FAA3 


629 




BNE 


NOFIX 


FA94:A9 


EO 




630 




LDA 


#$E0 



(D) FORMAT 



(E) FORMAT 



;new IRQ entry 



;{ should never be used) 
;for those who save A to $45 
;go to interrupt handler 



;save accumulator 



I SAVE REG'S ON BREAK 
INCLUDING PC 



;BRKV WRITTEN OVER BY DISK BOOT 

PRINT USER PC 

AND REGS 
GO TO MONITOR (NO PASS GO, NO $200!) 
DO THIS FIRST THIS TIME 



ANO = TTL LO 

AM = TTL LO 
CODE=INIT/RRA0981 
DO APPLE2E INIiyRRA0981 
/RRA0981 

TURN OFF EXTNSN ROM 

CLEAR KEYBOARD 

CAUSES DELAY IF KEY BOUNCES 
IS RESET HI 
A FUNNY COMPLEMENT OF THE 

PWR UP BYTE ??? 

NO SO PWRUP 

YES SEE IF COLD START 

HAS BERN DONE YET? 

DOF.S SOFT ENTRY VECTOR POINT AT BASIC? 









1 
1 
I 
■ 
I 
I 
■ 
■ 



■ 
I 
■ 
■ 



FA96:CD 


F3 


03 


631 




CMP 


SOFTEV+1 




FA99:D0 


08 


FAA3 


632 




BNE 


NOFIX 


YES SO REENTER SYSTEM 


FA9B:A0 


03 




633 


FIXSEV 


LDY 


#3 


NO SO POINT AT WARM START 


FA9D:8C 


F2 


03 


634 




STY 


SOFTEV 


FOR NEXT RESET 


FAAO : 4C 


00 


EO 


635 




JMP 


BASIC 


, AND DO THE COLD START 


FAA3s6C 


F2 


3 


636 


NO FIX 


JMP 


(SOFTEV) 


SOFT ENTRY VECTOR 


FAA6: 






637 


^kkkk^kkkkkkkkkkk-kkk 




FAA6:20 


60 


FB 


638 


PWRUP 


JSR 


APPLE I I 




FAA9: 




FAA9 


639 


SETPG3 


EQU 


* 


SET PAGE 3 VECTORS 


FAA9 : A2 


5 




640 




LDX 


n 




FAABiBD 


re 


FA 


641 


SETPLF 


LDA 


PWRCON-l ,X 


; WITH CNTRL B ADRS 


FAAE:9D 


E F 


03 


642 




STA 


BRKV-l.X 


OF CURRENT BASIC 


FAB1 :CA 






643 




DEX 






FAB2 : DO 


F7 


FAAB 


644 




BNE 


SETPLP 




FAB4 ; A9 


C8 




645 




LDA 


#$C8 


LOAD HI SLOT +1 


FAB6:86 


00 




646 




STX 


LOCO 


SETPG3 MUST RETURN X=0 


FAB8:85 


1 




647 




STA 


LOCI 


SET PTR H 


FABA: 






648 


* 








FABA: 






649 


* Check 


3 ID 


bytes lnste; 


id of 4. Allows devices 


FABA: 






650 


* other 


than 


Disk II's tc 


i be bootable. 


FABA: 






65 1 


* 








FABA:AO 


05 




652 


SLOOP 


LDY 


#5 ;l 


' is byte ptr 


FABC:C6 


0! 




653 




DEC 


LOCI 




FABE:A5 


0] 




654 




LDA 


LOCI 




FAC0:C9 


CO 




655 




CMP 


#$C0 


AT LAST SLOT YET? 


FAC2:F0 


D7 


FA9B 


656 




BEQ 


FLXSEV 


YES AND IT CAN'T BE A D1S 


FAC4:8D 


F8 


07 


657 




STA 


MS LOT 




FAC7:B1 


00 




658 


NXTBYT 


LDA 


(LOCO),Y 


FETCH A SLOT BYTE 


FAC9:D9 


1 


FB 


659 




CMP 


D1SKID-1 ,Y 


; IS IT A DISK ?? 


FACC:D0 


EC 


FABA 


660 




BNE 


SLOOP 


NO, SO NEXT SLOT DOWN 


FACE: 88 






661 




DEY 






PACK: 88 






662 




DEY 




YES, SO CHECK NEXT BYTE 


FADO:10 


F5 


FAC7 


663 




BPL 


NXTBYT j 


UNTIL 3 BYTES CHECKED 


FAD2:6C 


00 


00 


664 




JMP 


(LOCO) 


GO BOOT... 


FAD5: 






665 


A 








FAD 5 : K.A 






666 




NOP 






FAD6:EA 






667 




NOP 






FAD7 : 






668 


* 








FAD7:20 


8E 


FD 


669 


REGDSP 


JSR 


CROUT 


DISPLAY USER REG CONTENTS 


FADA:A9 


«b 




670 


RGDSP1 


LDA 


#545 


WITH LABELS 


FADC:85 


40 




671 




STA 


A3L 




FADE : A9 


00 




672 




LDA 


#$00 




FAEO;85 


41 




673 




STA 


A3H 




FAE2:A2 


FB 




674 




LDX 


#$FB 




FAE4:A9 


AO 




675 


RDSPl 


LDA 


#SA0 




FAE6:20 


El) 


I'D 


676 




JSR 


COUT 




FAE9:BD 


IE 


FA 


677 




LDA 


RTBL-251.X 




FAEC : 20 


ED 


FD 


678 




JSR 


COUT 




FAEF:A9 


BD 




679 




LDA 


#SBD 




FAF1:20 


ED 


FD 


680 




JSR 


COUT 




7-.?- :B5 






681 




LDA 


ACC+5 , X 




FAF6 :20 


L'A 


FD 


682 




JSR 


PRBYTE 




FAF9:E8 






683 




I NX 






FAFA:30 


E8 


FAE4 


684 




BMI 


RDSPl 








.:. 



FAFC 
FAFD 
FAFD 
FAFF 
FB02 
FB06 
FB09 
FB11 
FB11 
FB14 
FB16 
FB19 
FBL9 
FB1C 
FB1E 
FB21 
FB23 
FB24 
FB25 
FB28 
FB2A 
FB2B 
FB2D 
FB2E 
FB2K 
FB2F 
FB31 
FB33 
FB36 
FB39 
FB3C 
FB3E 
FB40 
FB43 
FB46 
FB49 
FB4B 
FB4D 
FB4F 
FB51 
FB53 
FB55 
FB57 
FB59 
FB5B 
FB5D 
FB60 
FB60 
FB63 
FB65 
FB68 
FB6B 
FB6C 
FB6E 



6(1 

59 FA 

00 EO 4 5 

20 FF 00 FF 



FF 3C 

FO FO EC 
FB11 



C4 C2 CL 
FF C3 

FF FF FF 

CI D8 D9 
DO D3 

AD 70 CO 

AO 00 

EA 

EA 

RD 64 CO 

10 04 

C8 

DO F8 

88 

60 



FB2E 



FB2S 



A9 00 

85 48 

AD 56 CO 

AD 54 CO 

AD 51 CO 

A9 00 

FO OB FB4S 

AD 50 CO 

AD 53 CO 

20 36 F8 

A9 14 

85 22 

A9 00 

85 20 

AO OC 

DO 5F 

A9 18 

85 23 

A9 17 

85 25 

4C 22 FC 

20 58 FC 
AO 09 
B9 09 FF 
99 OE 04 



FBB4 



DO F7 
60 



F865 



685 

686 * 

687 PWRCON 
688 

689 DISKID 

690 

691 

692 XLTBL 

693 

694 

695 

696 * 

697 KTBL 
698 

699 FREAD 

700 

701 

702 

703 PRE AD 2 

704 

705 

706 

707 

708 RTS2n 

1 * 

2 I NIT 
3 

4 

5 

6 SETTXT 

7 

8 

9 SETGR 
10 
1 i 
12 

13 SETWND 
14 
13 
16 
1.7 
L8 
L9 
20 

21 TABV 
22 

23 * 

24 APPLEII 
25 

26 STITLE 

27 

28 

29 

30 



RTS 

DW 

DFB 

DFB 

DFB 

ASC 

EQU 

DFB 

DFB 

DFB 

DFB 
DFB 
IDA 
LDY 
NOP 
NOP 
LDA 
BFL 
I NY 
BNE 
DEY 
RTS 

LDA 
STA 
LDA 
LDA 
LDA 
LDA 
BEG 
LDA 
LDA 
JSR 
LDA 
STA 
LDA 
STA 
LDY 
BNE 
LDA 
STA 
LDA 
STA 
JMP 

JSR 
LDY 
LDA 
STA 

DEY 

BNE 
RTS 



OLDBRK 
$00, $£0,545 
S20,SFF,S00,$FF 
$03,$FF,$3C 

'Apple ][' 
* 

SC4,SC2,$C1 
$FF,$C3 

$FF,$FF,$FF 

SC1,SD8,SD9 ;REGISTER NAMES FOR REGDSP: 

$D0,$D3 ;'AXYPS' 

PTRIG ;TRIGGER PADDLES 

#$00 ;INIT COUNT 

; COMPENSATE FOR 1ST COUNT 



PADDLO.X ; COUNT Y-REG EVERY 12 USEC. 
RTS2D 



PREAD2 



#$00 

STATUS 

LORES 

LOWSCR 

TXTSET 

#$00 

SEXWND 

TXTCLR 

MIX SET 

CLRTOP 

#$14 

WNDTOP 

#$00 

WNDLFT 

CSC 

GOTOCX 

#318 

WNDBTM 

U17 

CV 

VTAB 



;EXIT AT 255 M.AX 



;CLR STATUS FOR DEBUG SOFTWARE 



;INTT VIDEO MODE 
;SET FOR TEXT MODE 
;FULL SCREEN WINDOW 

;SET FOR GRAPHICS MODE 

; LOWER 4 LINES AS TEXT WINDOW 



SET FOR 40 COL WINDOW 
TOP IN A-REG, 

BOTTOM AT LINE $24 
CODE=SETWND /RRA0981 



;VTAB TO ROW 23 
;VTABS TO ROW IN A- REG 



; CLEAR THE SCFN 



HOME 

#9 

TITLE-l.Y ;GET A CHAR 

LINE1+14.Y ;PUT IT AT TOP CENTER OF SCREEN 

STITLE 









1 



1 
1 



1 
I 
1 
1 
1 
1 
I 
I 



FB6F 








31 


X 








FB6F 


:AD 


- : ; 


03 


02 


SETPWRC 


LDA 


SOFTKV+1 


; ROUTINE TO CALCULATE THE 'FUNN 


FB72 


49 


A5 




33 




EOR 


#$A5 


; COMPLEMENT 1 FOR THE RESET VECT 


FB74 


8D 


FA 


3 


14 




STA 


PWREDUP 




FB77 


60 






35 




RTS 






FB78 








16 


* 








FB78 






FB78 


37 


VIDWAIT 


EQU 


k 


;CHECK FOR A PAUSE (CONTROL-S), 


FB78 


C9 


8D 




38 




CMP 


#S8D 


;ONLY WHEN I HAVE A CR 


FB7A 


■00 


18 


FB94 


34 




BNE 


NOWAIT 


;NOT SO, DO REGULAR 


FB7C 


AC 


Oil 


CO 


40 




LDY 


KBD 


; IS KEY PRESSED? 


FB7F 


] 


13 


FB94 


41 




BPL 


NOWAIT 


;NO. 


FB81 


GO 


93 




4 2 




CPY 


#S93 


;YES ~ IS IT CTRL-S? 


FB83 


DO 


OF 


FB94 


43 




BNE 


NOWAIT 


;NOPE - IGNORE 


FB85 


2C 


LO 


CO 


44 




BIT 


KBDSTRB 


; CLEAR STROBE 


FB88 


AC 


00 


CO 


45 


KBDWAIT 


LDY 


KBD 


;WAIT TILL NEXT KEY TO RESUME 


FB8B 


10 


FB 


FB88 


46 




BPL 


KBDWAIT 


;WAIT FOR KEYPRESS 


FB8D 


CO 


83 




47 




CPY 


f'S83 


;IS IT CONTROL-C? 


FB8F 


PO 


3 


FB94 


48 




BEQ 


NOWAIT 


;YES, SO LEAVE IT 


FB91 


2C 


10 


CO 


u9 




BIT 


KBDSTRB 


;CLR STROBE 


FB94 


4C 


FD 


FB 


5 


NOWAIT 


JMP 


VIDOUT 


;DO AS BEFORE 


FB97 








51 


A 








FB97 


38 






52 


ESCOLD 


SEC 




; INSURE CARRY SET 


FB98 


4C 


2 


SO- 


3 




JMP 


ESC1 




FB9B 


&8 






54 


ESCNOW 


TAY 




;USE CHAR AS INDEX 


FB9C 


a9 


48 


FA 


3 5 




LDA 


XLTBL-SC9 


Y ; TRANSLATE IJKM TO CBAD 


FB9F 


2 


97 


FB 


56 




JSR 


ESCOLD 


;DO THE CURSOR MOTION 


FBA2 


2 


21 


FD 


57 




JSR 


RDESC 


;GET IJKM, ijkm, ARROWS/RRA0981 


FBA5 


CO 


C B 




58 


ESCNEW 


CMP 


#$CE 


;IS THIS AN 'N"> 


FBA7 


BO 


EB 


FB97 


5 4 




BCS 


ESCOLD 


;'N' OR GREATER - DO IT! 


FBA9 


C9 


C9 




60 




CMP 


//SC9 


;LESS THAN 'I 1 ? 


FBAB 


9Q 


EA 


FB97 


61 




BCC 


ESCOLD 


;YES, SO DO OLD WAY 


FBAD 


C9 


cc 




02 




CMP 


#SCC 


;IS IT AN 'L 1 ? 


FBAF 


FO 


E6 


FB97 


03 




BEQ 


ESCOLD 


;DO NORMAL 


FBB1 


DO 


E8 


FB9B 


64 




BNE 


ESCNOW 


;GO DO IT 


FBB3 








65 


* 








FBB3 






C006 


66 


SETSLOTCXROM 


EQU $C0O6 


;/RRA0981 


FBB3 






C007 


67 


SETINTCXROM 


EQU $C007 


;/RRA0981 


FBB3 






C015 


68 


RDCXROM 


EQU 


SC015 


;/RRA0981 


FBB3 








69 


* 






/RRA0981 


FBB3 


06 






70 


VERSION 


DFB 


$06 


;FOR IDCHECK./RRA0981 


FBB4 








71 


* 








FBB4 






FBB4 


n 


GOTOCX 


EOU 


* 


;/RRA0981 


FBB4 


2 


13 


GO 


73 




BIT 


RDCXROM 


;GET CURRENT STATE/ RRA09 81 


FBB7 


08 






74 




PHP 




;SAVE ROMBANK STATE/RRAQ981 


FBB8 


6 


07 


CO 


75 




STA 


SETINTCXROM ;SET ROMS ON/RRA0981 


FBBB 


4C 


Of) 


CI 


76 




JMP 


CI ORG 


;=>OFF TO CXS PACE/ RRAO 981 


FBBE 








77 


* 








FBBE 


00 






78 




DFB 







FBBF 


00 






79 




DFB 







FBCO 








OOi 


a 








FBCO 


EO 






81 


ZIDBYTE 


DFB 


SEO 


;//e ROM rev ID byte 


FBC1 








82 


* 








FBC1 


48 






83 


BASCALC 


PHA 




;CALC BASE ADDR IN BASL.H 


FBC2 


-\ 






84 




LSR 


A 


;FOR GIVEN LINE NO. 












FBC3:29 


03 




85 




AND 


#$03 ; 


OOLINE N0.<=$17 


FBC5:09 


04 




86 




ORA 


#S04 ;ARG = OOOABCDE, GENERATE 


FBC7:85 


29 




87 




STA 


BASH ; 


BASH - 000001CD 


FBC9:68 






88 




PLA 




AND 


FBCA:29 


IK 




89 




AND 


#$18 ; 


BASL = EABABOOO 


FBCC:90 


2 


FBDO 


90 




BCC 


BASCLC2 




FBCE:69 


7F 




91 




ADC 


#$7F 




FBD0:85 


2H 




92 


BASCLC2 


STA 


BASL 




FBD2:0A 






93 




ASL 


A 




FBD3:0A 






94 




ASL 


A 




FBD4:05 


Vh 




95 




ORA 


BASL 




FBD6:85 


28 




9o 




STA 


BASL 




FBD8:60 






97 




RTS 






FBD9: 






98 


■k 








FBD9;C9 


87 




99 


BELLI 


CMP 


#$87 


BELL CHAR? (CONTROL-G) 


FBDB : DO 


12 


FBEF 


LOO 




BNE 


RTS2B 


NO, RETURN! , 


F8DD: A9 


40 




101 




LDA 


#S40 


YES. . . 


FBDF:20 


A8 


FC 


102 




JSR 


WAIT 


DELAY .01 SECONDS 


FBE2:A0 


CO 




103 




LDY 


#SCO 




FBE4:A9 


oc 




104 


BELL2 


LDA 


#$oc 


TOGGLE SPEAKER AT 1 KHZ 


FBE6:20 


A8 


FC 


105 




JSR 


WAIT 


FOR ,1 SEC. 


FBE9:AD 


30 


CO 


106 




LDA 


SPKR 




FBEC:88 






107 




DEY 






FBED : DO 


r. 


FBE4 


108 




BNE 


BELL2 




FBEF:60 






109 


RTS2B 


RTS 






FBFO : 






110 


* 








FBFG:A4 


24 




HI 


STORADV 


LDY 


CH 


CURSOR H INDEX TO Y-REG 


FBF2:91 


28 




112 




STA 


(BASL),Y 


STORE CHAR IN LINE 


FBF4:EG 


24 




113 


ADVANCE 


INC 


CH 


INCREMENT CURSOR H INDEX 


FBF6: A5 


24 




114 




LDA 


CH 


(MOVE RIGHT) 


FBF8:C5 


2.1 




115 




CMP 


WNDWDTH 


BEYOND WINDOW WIDTH? 


FBFA:BO 


66 


FC62 


116 




BCS 


CR 


YES, CR TO NEXT LINE. 


FBFC: 60 






117 


RTS3 


RTS 




NO, RETURN. 


FBFD: 






118 


* 








t'BFD:C9 


&0 




119 


VIDOUT 


CMP 


#$A0 


CONTROL CHAR? 


FBFF:B0 


E F 


FBFO 


120 




BCS 


STORADV ; 


NO, OUTPUT IT. 


FCOl :A8 






121 




TAY 




INVERSE VIDEO? 


FG02J10 


EC 


FBFO 


122 




BPL 


STORADV 


YES, OUTPUT IT, 


FC04:C9 


8D 




123 




CMP 


#58D 


CR? 


FC06:F0 


5 A 


FC62 


124 




BEQ 


CR 


YES. 


FC08:C9 


6A 




125 




CMP 


#$8A 


LINE FEED? 


FCOA:FO 


5A 


FC66 


126 




BEQ 


LF ; 


IF SO, DO IT. 


FC0C:C9 


88 




127 




CMP 


#$88 


BACK SPACE? (CONTROL-H) 


FCOE : DO 


C9 


FBD9 


128 




BNE 


BELLI j 


NO, CHECK FOR BELL. 


FCL0:C6 


24 




129 


8S 


DEC 


CH 


DECREMENT CURSOR H INDEX 


FC12:lO 


E8 


FBFC 


130 




BPL 


RTS 3 


IF POSITIVE, OK; ELSE MO 


FC14:A5 


2 ! 




131 




LDA 


WNDWDTH 


SET CH TO WINDOW WIDTH - 


FC16:85 


24 




132 




STA 


CH 




FC18:C6 


24 




133 




DEC 


CH 


(RIGHTMOST SCREEN POS) 


FC1A:A5 


22 




134 


111 1 


LDA 


WNDTOP 


CURSOR V INDEX 


FC1C:C5 


2^ 




135 




CMP 


CV 




FC1E: BO 


OC 


FBFC 


136 




BCS 


RTS3 ; 


IF TOP LINE THEN RETURN 


FC20:C6 


25 




137 




DEC 


CV 


DECR CURSOR V INDEX 


FC22: 






138 


* 












! 



I 
1 
1 

1 
■ 
1 
■ 



■ 
I 
I 
I 
1 
■ 



FC22:A5 25 
FC24:85 28 
FC26:98 
FC27:AO 04 
FC29:D0 89 
FC2B: 
FC2B:EA 
FC2C: 

FC2C:49 CO 
FC2E:F0 28 
FC30:69 FD 
FC32:90 CO 
FC34:F0 DA 
FC36:69 FD 
FC38:90 2C 
FC3A:F0 DE 
FC3C:69 FD 
FC3E:90 5C 
FC40:D0 BA 
FC42: 
FC42 : 

FC42:A0 OA 
FC44:D0 E3 
FC46: 

FC46:2C IF 
FC49:10 04 
FC4B:A0 00 
FC4D:F0 OB 
FC4F:98 
FC50:48 
FC51 :20 78 
FC54:68 
FC55:A4 35 
FC57:60 
FC58: 
FC58: 

FC58-.A0 05 
FC5A:4C B4 
FC5D: 
FC5D:EA 
FC5H:EA 
FC5F-.EA 
FC60:EA 
FC61 :EA 
FC62: 

FC62;A9 00 
FC64:85 24 
FC66:E6 25 
FC68:A5 25 
FC6A:C5 23 
FC6C:90 B6 
FC6E:C6 
FC7C : 
FC70: 



FBB4 



FC53 

FBF4 
FC10 

FC66 

FC1A 

FC9C 
FBFC 

FC42 

FC29 

) 

FC4F 

FC5A 



CO 



FB 



FC58 



FB 



2S 



FC24 



FC70 



139 VTAB 

140 VTABZ 
14L 

142 

143 G0T0CX1 

144 * 
145 

146 * 

147 ESC1 
148 

149 
150 
151 
152 
153 
154 
155 
156 
157 

158 * 

159 CLREOP 
160 

161 

162 * 

163 NEWVW 
164 

165 

166 

167 NEWVW 1 

168 

169 

170 

171 

172 

173 * 

174 HOME 
175 

176 G0T0CX3 

177 * 
178 
179 
180 
181 
132 

183 * 

184 CR 
185 

186 LF 
187 
188 
189 
190 

191 * 

192 SCROLL 



LDA 
STA 
TYA 
LDV 
BNE 

NOP 

EOR 
BEO 
ADC 
BCC 
BEQ 
ADC 
BCC 
BEQ 
ADC 
BCC 
BNE 

EQU 
LDY 
BNE 

BIT 
BPL 
LDY 
BEQ 
TYA 
PHA 
JSR 
PLA 
LDY 
RTS 

EQU 
LDY 
JMP 

NOP 
NOP 
NOP 
NOP 
NOP 

LDA 
STA 
INC 
LDA 
CMP 
BCC 
DEC 

EQU 



CV 
BASL 

#S4 
GOTOCX 



#$C0 

HOME 

#SFD 

ADVANCE 

BS 

/;$fd 

LF 

UP 

tfSFD 

CLREOL 

RTS3 



GOTOCXl 

RD80VID 
NEWVW1 

#$0 
G0T0CX3 



VIDWA1T 
YSAV1 



#5 
GOTOCX 



#$00 

CH 

CV 

CV 

WNDBTM 

VTABZ 

CV 



;GET CURSOR V INDEX 
; temporarily save Ace 

;and Y 
;thls Is VTABZ call 
;=> always perform call 



ESC '(?'? 

IF SO DO HOME AND CLEAR 
ESC-A OR B CHECK 

A, ADVANCE 

B, BACKSPACE 
ESC-C OR D CHECK 

C, DOWN 

D, GO UP 
ESC-E OR F CKECK 

E, CLEAR TO END OF LINE 
ELSE NOT F, RETURN 

/RRA0981 

CODE=CLREOP/RRA098 1 
DO 40/80 /RRA0981 



[in 80 columns? 
;=>not 80 columns 
;Prlnt a character 
; through video firmware 
;get masked character 
;and set up for vidwait 
; print the character 
;restore Ace 
;and Y 



;/RRA0981 

;COD£=HOME/RRA0981 
;do 40/80 



; CURSOR TO LEFT OF INDEX 

;(RET CURSOR H=0) 

;INCR CURSOR V. (DOWN 1 LINE) 

;OFF SCREEN? 

• NO, SET BASE ADDR 

jBECR CURSOR V. (BACK TO BOTTOM) 

;/RRA0981 



- 



361 



FC70:A0 06 
FC72:DO B5 
FC74: 
FC74: 
FC7 4: 
FC74: 

FC74:8D 06 
FC7 7:6C FE 
FC7A: 
FC7A: 
FC7A: 
FC7A: 
FC7A:68 
FC7B:8D F8 
FC7E:C9 CI 
FC80:90 0D 
FC82:8D FF 
FC85:A0 00 
FC87:A6 01 
FC89:85 01 
FC8fl:Bl 00 
FC8D:86 01 
FC8F:3D 07 
FC92:4C 7C 
FC95: 

FC95;90 02 
FC97:25 32 
FC99:4C F7 
FC9C: 
FC9C: 
FC9C: 
FC9C; 
FC9C: 
FC9C: 
FC9C:38 
FC9D:90 
FC9E:18 
FC9F:84 2A 
FCA1:A0 07 
FCA3:B0 78 
FCA5:C8 
FCA6:D0 75 
FCA3: 
FCA8:38 
FCA9:48 
FCAA:E9 01 
FCACsDO FC 
FCAE:68 
FCAF:E9 01 
FCB1:D0 F6 
FCB3:60 
FC84: 

FCB4:E6 42 
FCB6:D0 02 



FC2 9 



LDY 
BNE 



CO 
03 



7 



FC8F 



CF 



CO 
C4 



FC99 



FD 



0000 



FD1D 
FD1D 



FCAA 



FCA9 



FCBA 



Jump here to swap out ROMs 

for interrupt handlers in peripheral cards 



193 

194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 IRQDONE2 PLA 



#6 
GOTOCX1 



;CODE=SCROLL/RRA0981 
;DO 40/80 /RRA0981 



IRQUSER STA 
JMP 



SETSLOTCXROM ;switch in slots 
C?3FE) ;and jump to user 



* IRQDONE ($C3F4) jumps here after interrupt 

* because this cannot be done from $CnOO space 

* 



206 
207 
208 
209 
210 
211 
212 
213 
214 



STA 
CMP 
BCC 
STA 
LDY 
LDX 
STA 
LDA 
STX 



MS LOT 

/>$C1 

ERQNOSLT 

$CFFF 

#0 

$1 

SI 

($0),Y 

Si 



;FIx SC800 space 
;restore M5L0T 
;valid Cn? 

;Deselect all $C800 



215 IRQNOSLT STA SETINTCXROM 



;do $CnO0 reference 
;fix zp location 



216 

217 * 

218 D0C0UT1 BCC 

2 1 9 AND 

220 DOC0UT2 JMP 

221 * 

222 DS 

223 * 
224 
225 
226 
227 
228 



JMP IRQFIX 



D0C0UT2 

INVFLG 
C0UTZ1 



;and restore the machine state 

;don't mask controls 
; apply inverse mask 
;go back to COUT1 



F8ORG+$49C-*,0 ;pad to clreol 



Note: bytes CLREOL and CLREOLZ ($38 and $18) 
are used by slot test at $FBB7. 



CLREOL 



SEC 
DFB 

229 CLREOLZ CLC 

230 STY 

231 LDY 

232 BCS 

233 I NY 

234 BNE 

235 * 

2 36 WAIT SEC 

237 WAIT2 PHA 

238 WAIT 3 SBC 

239 BNE 

240 PLA 

241 SBC 

242 BNE 

243 RTS 

244 * 

245 NXTA4 INC 

246 BNE 



$90 
BAS2L 

in 

GOT OCX 2 
GOTOCX2 



£$01 
WAIT3 

#$01 
WAIT2 



A4L 

NXTA1 



;say it is EOL 

;'BCC' opcode 

;say it is EOLZ 

;save Y in temp 

;code=CLRE0L 

;do it 

;code 8=CLRE0LZ 



;enter with count in A 
;delay is: 

;13+11*A+5*A*A cycles 
;@ 1.023 usee per cycle 








;INCR 2 -BYTE A4 
: AND Al 






1 



FCB8 

FCBA 

FCBC 

FCBE 

FCCO 

FCC2 

FCC4 

FCC 6 

FCC8 

FCC 9 

FCC 9 

FCCC 

FCCF 

FCD2 

FCD2 

FCD2 

FCD2 

FCD2 

FCD2 

FCD2 

FCD5 

FCD8 

FCDA 

FCDD 

FCEO 

FCE3 

FCB3 

FCE6 

FCE9 

FCEC 

FCEE 

FCFO 

FCFO 

FCFO 

FCFO 

FCFO 

FCF2 

FCF4 

FCF7 

FCFA 

FCFD 

FCFD 

FDOO 

FDOl 

FD03 

FDD 5 

FD07 

FD09 

FDOB 

FDOC 

FDOC 

FDOE 

FDIO 

FD13 



E6 43 
A5 3C 
C5 3E 
A5 3D 
E5 3F 
E6 3C 
DO 02 
E6 3D 
60 

BD 07 
20 67 
4C C5 



FCC 8 



CO 

C5 

fe 



8D 06 
20 4A 
A 9 DE 
20 ED 
20 3A 
4C FO 

8D 06 
20 DO 
20 53 

84 3B 

85 3A 



CO 
F5 

FD 

FF 
FC 

CO 

K- 
py 



A9 Al 
85 33 
20 67 
8D 07 

4C 9C 

B9 00 
C8 

C9 El 
90 06 
C9 FB 
BO 02 
2 9 DF 
60 

AO OB 
DO 03 
4C 18 
20 B4 



FD 

CO 
CF 

02 



FDOB 
FDOB 

FD13 



Pis 
FB 



247 
248 

249 

250 

2GL 

252 

253 

254 

255 

256 

257 

258 

259 

260 

261 

262 

263 

264 

265 

266 

267 

268 

269 

270 

271 

272 

273 

274 

275 

276 

277 

278 

279 

280 

281 

282 

283 

284 

285 

286 

287 

288 

289 

290 

29L 

292 

293 

294 

295 

296 

297 

298 

299 

300 



NXTA! 



1NCR 2-BYTE Al . 
; AND COMPARE TO A2 
(CARRY SET IF >=) 



RTS4B 
HEADR 



INC A4H 

LDA AIL 

CMP A2L 

LDA AlH 

SBC A2H 

INC AIL 

BNE RTS4B 

INC AlH 
RTS 



STA SETINTCXROM ; force internal ROM 

JSR XHEADER ;write header 

JMP RRTCX1 ;force slots and return 



* For the disassembler to be able to do I/O to slots, 

* It cannot make calls to the I/O routines with the. 

* internal ROM switched in. This stuff switches the 

* ROM out for such instances. 
* 

ERR3 STA SETSLOTCXROM ; force slot ROM 

JSR PRBL2 ;tab to the error 

LDA #$DE ;to print a caret """ 

JSR COUT ;print it 

JSR BELL ;and beep 

JMP GETINST1 ;and go get next instruction 
* 

DISLIN STA SETSLOTCXROM ;force slot ROM 

JSR INSTDSP 

JSR PC AD J 

STY PCH 

STA PCL 



;disassemble the instruction 
;calculate new PC 
;and update PC 



* NOTE: The entry point GETINST1 is hard-coded in 

* BFUNC of the Video firmware. 



GETINST1 LDA 
STA 
JSR 
STA 
JMP 



UPHON 



UPM0N2 

RDKEY 

FDIO 

RDKEY 



LDA 
IKY 
CMP 
BCC 
CMP 
BCS 
AND 
RTS 

LDY 
BNE 

JMP 
JSR 



#SA1 ;get mini-prompt "!" 

PROMPT 

GETLNZ ;go get a line of input 

SETINTCXROM ; force internal ROM 

DOINST ;and return to CX space 

IN,Y ;get character 

;point to next char 

#$E1 ;is it lowercase? 

UPM0N2 ;=>nope 

#$FB ;lowercase? 

UPMON2 ;=>nope 

ffSDF ;else upshift 



#SB ;code=RDKEY 

RDKEYO ;allow SFD10 entry 

RDKEY1 ;if enter here, do nothing 

GOTOCX ;display cursor 






FD16 

FD1 7 : 

FD18 

FIHB: 

KD1B 

FDIBi 

FD1D 

FDZO: 

FD21 

FD21 : 

FD21 ; 

FD24: 

FD26: 

FD28: 

FD28; 

FD28: 

FD28: 

FD28: 

FD28 : 

FD28; 

FD2B: 

FD2E: 

FD2F; 

FD2F: 

FD32: 

FD35 : 

FD38: 

FD3A: 

FD3C: 

FD3D: 

FD3D: 

FD3F: 

FD42: 

FDA 4 ; 

FD47: 



:5A 

EA 

6C 38 00 

FD1B 

AO 03 
4C B4 FB 
EA 

FD21 
20 OC FD 
AO 01 
DO F5 FD1D 



4E F8 07 
4C OC FD 

EA 

20 21 FD 

20 A5 FB 

20 28 FD 

C9 9B 

FO F3 FD2F 

60 

AO OF 
20 B4 FB 
A4 24 
9D 00 02 



301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
3U 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 



RDKEY1 



KF.YIN 



NOP 
NOP 
JMP 



EQU 

LDY 

G0TOCX2 JMP 

NOP 



RDESC 



EQU 
JSR 
LDY 

BNE 



(KSWL) ;G0 TO USER KEY-IN 



iB ;RDKEY/RRAQ981 
GOTOCX ;/RRA0981 
/RRA0981 



RDKEY ;GET A KEY 
#1 ;CODE=FIXIT 

G0T0CX2 ;=>always 



Flag to the video firmware that escapes are allowed, 
This routine is called by RDCHAR which is called by 
GETLN. The high bit of MSLOT is set by all cards 
that use the C800 space. 



NEWRDKEY LSR MSLOT 
JMP RDKEY 
NOP 



ESC 



RDCHAR 



JSR 

JSR 
JSR 
CMP 

BEQ 
RTS 



PICKFIX LDY 

JSR 
LDY 
STA 
*#03 ALFT0ST2 



RDliSC 

ESCNEW 

NEWRDKEY 

//S9B 

ESC 



;<128 means escape allowed 
;now read the key 



/RRA0981 

HANDLE ESC FUNCTION. 

Flag RDCHAR and read key 

'ESC'? 

YES, DON'T RETURN. 



#$F ;code = fixpick 
GOTOCX ;do 80 column pick 
CH ;restore Y 
IN,X ;artd save new character 

Auto-Start Monitor ROM 27-AUG-84 
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FD47: 
FD4A; 
FD4B: 
FD4C: 
FD4D: 
FD50: 
FD5 2: 
FD54: 
FD56: 
FD58: 
FD5A: 
FD5C: 
FD5F: 
FD60: 
FD62: 
FD62; 
FD64: 
FD67: 



20 ED FD 

EA 

EA 

EA 

BD 00 02 

C9 88 

FO ID 

C9 98 

FO OA 

EO F8 

90 03 

20 3A FF 

E8 

DO 13 FD75 

A9 DC 
20 ED FD 
20 8E FD 



FD71 



FD62 



FD5F 



336 NOTCR 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 

348 NOTCR1 

349 

350 * 

351 CANCEL 
352 

353 GETLNZ 



JSR 
NOP 
NOP 
NOP 
LDA 
CMP 
BEQ 
CMP 
BEQ 
CPX 
BCC 
JSR 
I NX 
BNE 



COUT 



IN,X 

#S88 

BCKSPC 

#$98 

CANCEL 

#?F8 

NOTCR1 

BELL 

NXTCH&R 



LDA #SDC 
JSR COUT 
JSR CROUT 



;echo typed char 



;CHECK FOR EDIT KEYS 
; - BACKSPACE 

; - CONTROL-X 

; MARGIN? 

; YES, SOUND BELL 

; ADVANCE INPUT INDEX 



; BACKSLASH AFTER CANCELLED LINE 
; OUTPUT 'CR' 






FD6A:A5 


33 


354 


GETLN 


LDA 


PROMPT 


FD6C:20 


ED FD 


355 




JSR 


COUT 


FD6F : A2 


01 


356 




LDX 


#$01 


FD7 1 : 8A 




357 


BCKSPC 


TXA 




FD72:FO 


F3 FD67 


358 




BEQ 


GETLNZ 


FD74:CA 




359 




DEX 




FD75:20 


35 FD 


360 


NXTCHAR 


JSR 


RDCHAR 


FD78rC9 


95 


361 




CMP 


#$95 


FD7A:D0 


08 FD84 


362 




BNE 


ADDINP 


FD7C:B1 


28 


363 




LDA 


(BASL),Y 


FD7E:2C 


IF CO 


364 




BIT 


RD80VID 


FD81:30 


BA FD3D 


365 




BM.I 


PICKFIX 


FD83:EA 




366 




NOP 




FD84:9D 


00 02 


367 


ADDINP 


STA 


IN,X 


FD87:C9 


8D 


368 




CMP 


#$8D 


FD89:D0 


BC FD47 


369 




BNE 


NOTCR 


FD8B:20 


9C FC 


370 




JSR 


CLREOL 


FD8E;A9 


8D 


371 


CROUT 


LDA 


j?$8D 


FD90:D0 


5B FDED 


372 




BNE 


COUT 


FD92: 




373 


* 






FD92:A4 


3D 


374 


PRA1 


LDY 


AIM 


FD94:A6 


3C 


375 




LDX 


AIL 


FD96:20 


8E FD 


376 


PRYX2 


JSR 


CROUT 


FD99:20 


40 F9 


377 




JSR 


PRNTYX 


FD9C:A0 


00 


378 




LDY 


#500 


FD9E:A9 


AD 


379 




LDA 


//SAD 


FDA0:4C 


ED FD 


380 




JMP 


COUT 


FDA3: 




381 


* 






FDA3 : A5 


3C 


382 


XAMB 


LDA 


AIL 


FDA5:09 


07 


383 




ORA 


#$07 


FDA7:85 


3- 


38i 




STA 


A2L 


FDA9:A5 


JD 


385 




LDA 


A1H 


FDAB:85 


3F 


386 




STA 


A2H 


FDAD : A3 


3C 


387 


MO 






D8CHK LDA AIL 










FDAF:29 


07 


388 




AND 


#$07 


FDB1 :D0 


03 FDB6 


389 




BNE 


DATAOUT 


FDB3:20 


92 FD 


390 


XAM 


JSR 


PRA1 


FDB6:A9 


AO 


391 


DATAOUT 


LDA 


#$AO 


FDB8:20 


ED FD 


392 




JSR 


COUT 


FDBB: Bl 


3C 


393 




LDA 


<A1L),Y 


FDBD:20 


DA FD 


394 




JSR 


PR BYTE 


FDC0:20 


BA FC 


395 




JSR 


NXTA1 


FDC3:90 


E8 FDAD 


396 




BCC 


MOD8CHK 


FDC5:60 




397 


RTS4C 


RTS 




FDC6: 




398 


* 






FDC6:4A 




399 


XAMPM 


LSR 


A 


FDC7:90 


EA FDB3 


400 




BCC 


XAM 


FDC9:4A 




401 




LSR 


A 


FDCA:4A 




402 




LSR 


A 


FDCB:A5 


3E 


403 




LDA 


A2L 


FDCD : 90 


02 FDD1 


404 




BCC 


ADD 


FDCF:49 


FF 


405 




EOR 


#SFF 


FBD1:65 


3C 


406 


ADD 


ADC 


AIL 



; OUTPUT PROMPT CHAR 
;INIT INPUT INDEX 
;WILL BACKSPACE TO 



USE SCREEN CHAR 

FOR CONTROL-U 
do 40 column pick 
80 columns? 
=>yes, fix it 

;ADD TO INPUT BUFFER 



CLR TO EOL IF CR 

(ALWAYS) 

PRINT CR,AL IN HEX 

;PRINT '-' 



[SET TO FINISH AT 
; MOD 8=7 



; OUTPUT BLANK 

; OUTPUT BYTE IN HEX 

;NOT DONE YET. GO CHECK. MOD 8 
;DONE. 

; DETERMINE IF MONITOR MODE IS 
; EXAMINE, ADD OR SUBTRACT 



;FORM 2'S COMPLEMENT FOR SUBTRACT. 



Apper i 'or ROM Li 



■jt«, 



FDD3:48 




FDD4:A9 


BD 


FDD6:20 


ED FD 


FDD9:68 




FDDA:48 




FDDB:4A 




FDPC:4A 




FDDD:4A 




FDDE:4A 




FDDF:20 


E5 FD 


FDE2:68 




FDE3:29 


OF 


FDE5:09 


BO 


FDE7:C9 


BA 


FDE9:90 


02 ! 


FDEB:69 


06 


FDED: 




FDED : 6C 


36 00 


FDFO: 




FDF0:48 




FDF1:C9 


AO 


FDF3:4C 


95 FC 


FDF6: 




FDF6:48 




FDF7:84 


35 


FDF9 : A8 




FDFA:68 




FDFB:4C 


46 FC 


FDFE:EA 




FDFF;EA 




FEOO: 




FE0O:C6 


34 


FE02:FO 


9F I 


FE04:CA 




FE05:DO 


16 I 


FE07:C9 


BA 


FE09:DO 


BB I 


PR0B:85 


31 


FE0D:A5 


3E 


FE0F;91 


40 


FE11:E6 


40 


FE13:D0 


02 1 


FE15:E6 


41 


FE17:60 




FE18: 




FE18:A4 


34 


FE1A:B9 


FF 01 


FE1D:85 


31 


FE1F:60 




FE20: 




FE20:A2 


01 


FE22:B5 


3B 


FE24:95 


42 


FE26:95 


44 



FDED 



FDA3 



FE1D 



FDC6 



FE17 



407 


PHA 




408 


LDA 


#SBD 


409 


JSR 


COUT 


410 


FLA 




411 PRBYTE 


PHA 




412 


LSR 


A 


413 


LSR 


A 


414 


LSR 


A 


415 


LSR 


A 


416 


JSR 


PRHEXZ 


417 


PLA 




418 PRHEX 


AND 


#$0F 


419 PRHEXZ 


ORA 


#$B0 


420 


CMP 


#$BA 


421 


BCC 


COUT 


422 


ADC 


#$06 


423 * 






424 COOT 


JMP 


(CSWL) 


425 * 






426 C0UT1 


PHA 




427 


CMP 


#$A0 


428 


JMP 


D0COUT1 


429 * 






430 COUTZ 


PHA 




431 CQUTZ1 


STY 


YSAV1 


432 


TAY 




433 


PLA 




434 


JMP 


NEWVW 


435 


NOP 




436 


NOP 




437 * 






438 BL1 


F1EC 


YSAV 


439 


BEQ 


XAM8 


440 BLANK 


DEX 




441 


BNE 


SETMDZ 


442 


CMP 


#$BA 


443 


BNE 


XAMPM 


444 STOR 


STA 


MODE 


445 


LDA 


A2L 


446 


STA 


(A3L),Y 


447 


INC 


A3L 


448 


BNE 


RTS5 


449 


INC 


A3H 


450 RTS5 


RTS 




451 * 






452 SETMODE 


LDY 


YSAV 


453 


LDA 


IN-l.Y 


454 SETMDZ 


STA 


MODE 


455 


RTS 




456 * 






457 LT 


LDX 


0SO1 


458 LT2 


LDA 


A2L.X 


459 


STA 


A4L.X 


460 


STA 


A5L.X 



;PRINT ' = ', THEN RESULT 



; PRINT BYTE AS 2 HEX DIGITS 
; (DESTROYS A-REG) 



; PRINT HEX DIGIT IN A-REG 
;LSBITS ONLY. 



; VECTOR TO USEE OUTPUT ROUTINE 

;save original character 

;ls It a control? 

=>mask if not; return to COUTZ1 

;save original character 
;save Y 

;save masked character 
;get original char 
;new entry to vidwait 



; BLANK TO MON 

; AFTER BLANK 

;DATA STORE MODE? 

; NO; XAM, ADD, OR SUBTRACT. 

;KEEP IN STORE MODE 

; STORE AS LOW BYTE AT (A3) 

;INCR A3, RETURN. 



;SAVE CONVERTED ' : *, '+'. 
; '-' , ' . ' AS MODE 



;COPY A2 (2 BYTES) TO 
; A4 AND A5 









FE28:CA 






46L 




DEX 




FE2 9:10 


^7 


FE22 


462 




BPL 


LT2 


FE2B:60 






463 




RTS 




FE2C: 






464 


* 






FE2C:B1 


3C 




465 


MOVE 


LDA 


(A1L),Y 


FE2E:9i 


42 




466 




STA 


(A4L),Y 


FE30;2O 


B4 


FC 


467 




JSR 


NXTA4 


FE33:90 


F7 


FE2C 


468 




BCC 


MOVE 


FE35:60 






469 




RTS 




FE36: 






470 


* 






FE36:B1 


3C 




471 


VFY 


LDA 


(A1L),Y 


FE38:D1 


42 




472 




CMP 


(A4L),Y 


FE3A:F0 


1C 


FE58 


473 




BEQ 


VFYOK 


FE3C;20 


92 


FD 


474 




JSR 


PRA1 


FE3F:B1 


3C 




475 




LDA 


(A1L),Y 


FE41:20 


DA 


FB 


476 




JSR 


PRBYTE 


FE44:A9 


AO 




477 




LDA 


//SAO 


FE46:20 


ED 


ED 


478 




JSR 


COUT 


FE49:A9 


A 8 




479 




LDA 


#SA8 


FE4R:20 


ED 


FD 


480 




JSR 


COUT 


FE4E:B1 


43 




481 




LDA 


(A4L),Y 


FE50:20 


DA 


ED 


482 




JSR 


PRBYTE 


FE53;A9 


A 9 




483 




LDA 


#SA9 


FE55:20 


ED 


ED 


484 




JSR 


COUT 


FE58:20 


B* 


FC 


485 


VFYOK 


JSR 


NXTA4 


FE5B:90 


D9 


FE36 


486 




BCC 


VFY 


FE5D:60 






487 




RTS 




FE5E: 






488 


* 






FE5E:20 


75 


FE 


489 


LIST 


JSR 


A1PC 


FE61:A9 


L4 




490 




LDA 


#$14 


FE63:48 






491 


LTST2 


PHA 




FE64 ;20 


DO 


F8 


492 




JSR 


INSTDSP 


FE67:20 


S3 


P9 


493 




JSR 


PC AD J 


FE6A;85 


3 A 




494 




STA 


PCL 


FE6C:84 


3B 




495 




STY 


PCH 


FE6E:68 






496 




PLA 




FE6F:38 






497 




SEC 




FE70:E9 


01 




498 




S8C 


#$01 


FE7 2:DO 


E F 


FE63 


499 




BNE 


LIST2 


FE74:60 






500 




RTS 




FE7 5 : 






501 


ft 






FE75:8A 






502 


A1PC 


TXA 




FE7 6:FO 


07 


FE7F 


503 




BEQ 


Al PCRTS 


FE73;B5 


3C 




504 


A1PCLP 


LDA 


A1L.X 


FE7A:95 


3 A 




505 




STA 


PCL.X 


FE7CtCA 






506 




DEX 




FE7D:10 


F9 


FE78 


507 




BPL 


A1PCLP 


FE7F:60 






508 


Al PORTS 


RTS 




FE8 : : 






509 


* 






FE80:AO 


3F 




510 


SETINV 


LDY 


i f $3F 


?E82:DO 


'■: 


FE86 


511 




BNE 


SETIFLG 


FES4:AQ 


77 




512 


SeTNORV 


LDY 


#$FF 


FE8G :84 


32 




513 


SETIFLG 


STY 


INVFLG 


■ • 






514 




RTS 





;MOVE (Al) THRU (A2) TO (A4) 



; VERIFY (Al) THRU (A2) 
; WITH (A4) 



;MOVE Al (2 BYTES) TO 

; PC IF SPEC'D AND 

; DISASSEMBLE 20 INSTRUCTIONS. 

; ADJUST PC AFTER EACH INSTRUCTION. 



;NEXT OF 20 INSTRUCTIONS 



•IF USER SPECIFIED AN ADDRESS, 
; COPY IT FROM Al TO PC. 
;YEP, SO COPY IT. 



;SET FOR INVERSE VID 

; VIA C0UT1 

:SET FOR NORMAL VID 






■¥i 



FE89 
FES 9 
FE8B 
FE8D 
FE8F 
FE91 
FE93 
FE93 
FE95 
FE97 
FE99 
FE9B 
FE9D 
FE9F 
FEA1 
FEA3 
FEA5 
FEA7 
FEA9 
FEAB 
FEAE 
FEAE 
FEAF 

Ft; 60 

FEBO 
FEB3 
FEB6 
FEB9 
FEBC 
FEBF 
FEC2 
FEC3 
FEC4 
FEC5 
FEC5 
FEC5 
FEC5 
FEC5 
FEC5 
FEC5 
FEC8 
FEC9 
FECA 
FECA 
FECD 
FECD 
FECF 
FED2 
FED5 
FED? 
FED7 
FED7 
FED7 
FED7 



A9 00 
85 3E 
A2 38 
AO IB 
DO 08 FE9B 



A9 00 
85 3E 
A2 36 
AO FO 
A5 3E 
29 OF 
FO 04 
09 CO 
AO 00 

94 00 

95 01 
AO OE 

4C 84 FB 



FEA5 



EA 

00 

4C 00 EO 
4C 03 EO 
20 75 FE 
20 3F FF 
6C 3A 00 
AC D7 FA 
60 
EA 
60 



8D 06 CO 

60 

EA 

4C F8 03 

A9 40 
8D 07 CO 
20 AA C5 
FO 2C FF03 



515 

516 

517 

518 

519 

520 

521 

522 

523 

524 

525 

526 

527 

528 

529 

530 

531 

532 

533 

534 

535 

536 

537 

538 

539 

540 

541 

542 

543 

544 

545 

546 

547 

548 

549 

550 

551 

552 

553 

554 

555 

556 

557 

558 

559 

560 

561 

562 

563 

564 

565 

566 

567 

568 



SETKBD 
IMPORT 
INPRT 



LDA 
STA 
LDX 
LDY 
BNE 



SETVID LDA 

OUTFORT STA 

OUTPRT LDX 

LDY 

LDA 

AND 

BEQ 

ORA 

LDY 

STY 

STA 

LDY 

G0T0CX4 JMP 



IOPRT 



I0PRT1 



#$00 
A2L 
#KSWL 
#KEYIN 

IOPRT 

#$00 

A2L 

#CSWL 

#COUT] 

A2L 

#$0F 

IOPRT 1 

KlOADR 

#$00 

LOC0,X 

L0C1.X 

#$E 

GOTOCX 



;D0 
;D0 



;D0 
j DO 



'INifO' 
IN#AREG' 



1 PR#0 ' 
PR#AREG ' 



;SET INPUT/ OUTPUT VECTORS 



save low byte of hook 
save ace 
code=PR#/IN0 
perform call 



NOP 

CKSUMFTX DFB 



;/RRA0981 



->C0RRECT CKSUM AT CREATE TIME. 



XBASIC JMP 
BASCONT JMP 



GO 



REGZ 
TRACE 



STEPZ 



JSR 
JSR 
JMP 
JMP 
RTS 
NOP 
RTS 



BASIC 
BASIC2 

A1PC 
RESTORE 
(PCL) 
REGDSP 



TO BASIC, COLD START 
TO BASIC, WARM START 
ADDR TO PC IF SPECIFIED 
RESTORE FAKE REGISTERS 
AND GO! 

GO DISPLAY REGISTERS 
TRACE IS GONE 

;STEP IS GONE 






* Return here from GOTOCX 



* NOTE: This? address Is hard-coded In BFUNC of the 



* video firmware 



RETCX1 
RETCX2 



USR 



WRITE 
WRT2 



STA 
RTS 
NOP 



SETSLOTCXROM ; res tore bank 
; simply return 



JMP USRADR 



;JUMP TO CONTROL -Y VECTOR IN RAM 



LDA #S40 

STA SETINTCXROM ;set internal ROM 

JSR WRITE2 ;write to tape 

BEQ RD2 ;=>always set slots, 



beep 



SEARCH is called with a Monitor command of the form 
HHLL<ADR1.ADR2 in which ADR1 < ADR2 and LL precedes HH 
in memory. If HH is 0, or omitted (LL<ADR1 .ADR2) , then 
the single byte LL is searched for. You cannot search for 






■ 
■ 
■ 



■ 
I 



FED7 
FED? 
FED7 
FED? 
FED9 
FEDB 
FEDD 
FEDF 
FEE1 
FEE2 
FEE4 
FEE6 
FEES 
FEEB 
FEEE 
FEFO 
FEF1 
FEF1 
FEF3 
FEF6 
FEF6 
FEF9 
FEFA 
FEFB 
FEED 
FEFD 
FFOO 
FF03 
FF06 
FF08 
FFOA 
FFOA 
FF13 
FF13 
FF13 
FF13 
FF16 
FF18 
FF1A 
FF1B 
FF1B 
FF1D 
FF1F 
FF21 
FF24 
FF2 n 
FF28 
FF2A 
FF2B 
FF2D 

?:■::. 



FEEl 



FEEB 



FEEB 



FED7 



AO OL 
A5 43 
FO 04 
Dl 3C 
DO OA 
88 

A5 42 
Dl 3C 
DO 03 
20 92 FD 
20 BA FC 
90 E7 
60 

AO OD 
20 B4 FB 



20 00 FE 

68 

68 

DO 6C FF69 

8D 07 CO 
20 Dl C5 
8D 06 CO 
FO 32 FF3A 
DO 23 FF2D 

CI FO FO EC 



20 FD FC 

C9 AO 

FO F9 FF13 

60 

BO 6D FF8A 

C9 AO 

DO 28 FF49 

B9 00 02 

A2 07 

C9 80 

FO 7D 

C8 

DO 63 



FFA7 



FF90 



A9 C5 
20 ED FD 
A9 D2 
ZO ED FD 



569 
570 
571 
572 
573 
574 
575 
576 
577 
578 
579 
580 
581 
582 
583 
584 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 
595 
596 
597 
598 
599 
600 
601 
602 
603 
604 
605 
606 
607 
608 
609 
610 
611 
612 
613 
614 
615 
616 
617 
618 
619 
620 
621 
622 



* a two byte pair with a high byte of 0. A list of all 

* adresses containing the specified pattern is displayed. 



SEARCH 



SRCH1 



SRCH2 



MINI 



CRMON 



READ 



RD2 



TITLE 
* NNBL 
NNBL 



LDY 
LDA 
BEQ 
CMP 
BNE 
DEY 
LDA 
CMP 
BNE 
JSR 
JSR 
BCC 
RTS 

LDY 
JSR 

JSR 
PLA 
PLA 
BNE 

STA 
JSR 
STA 
BEQ 

BNE 

ASC 



#1 ;set Y to 1 

A4H ;is high byte 0? 

SRCH1 ;=>yes, only look for low byte 

(AIL),Y ;check high byte first 

SRCH2 ;=>no match, try next byte 
;niatch, now check low byte 

A4L ;get low byte 

(A1L),Y ;does it match? 

SRCH2 ;=>no match, try next byte 

PRA1 ;bytes match, print address 

NXTA1 ; increment address 

SEARCH ;set Y back to 1 



#$D jdispatch mini-assembler call to 
GOTOCX ;get internal ROM switched in 

BL1 ;HANDLE CR AS BLANK 

THEN POP STACK 

AND RETURN TO MON 
MON2 ; (ALWAYS) 

SETINTCXROM ; set internal ROM 
XREAD ;do tape read 
SETSLOTCXROM ; restore slot CX 



BELL 
PRERR 



"Apple 
gets the next 



JSR 
CMP 

BEQ 
RTS 
* 

LOOKASC BCS 
CMP 
BNE 
LDA 
LDX 
CMP 
BEQ 
INY 
BNE 



PRERR 



LDA 
JSR 
LDA 
JSR 



UPMON 

#$A0 
NNBL 



DIG 

#SAD 

RTS6 

$200, Y 

#7 

0$8D 

GETNUM 

NXTBIT 

#SC5 
COUT 
#$D2 

COUT 



;read (write) ok, beep 
;error, print message 

//e" 

non-blank for the mini-assembler 

;get char, upshift, INY 
;is it blank? 
;yes, keep looking 



;it was a digit 

; check for quote (') 

;nope, return char 

;else get next char 

;for shifting asc lnco A2L and A2H 

;was it CR? 

;yes, go handle CR 

;advance index 

;=>( always) into A2L and A2H 

;PRINT 'ERR', THEN FALL INTO 
: FWEEPER. 






FF37:20 
FF3A: 


ED 


FD 


623 
624 


A 


JSR 


COUT 


FF3A:A9 


8 7 




625 


BELL 


LDA 


#587 ; 


FF3C:4C 


ED 


FT) 


626 




JMP 


COUT 


FF3F: 






627 


* 






FF3F;A5 


48 




628 


RESTORE 


LDA 


STATUS ; 


FF41:48 






629 




PHA 


, 


FF42:A5 


45 




630 




LDA 


A5H 


FF44:A6 


46 




631 


RESTR1 


LDX 


XREG 


FF46:A4 


47 




632 




LDY 


YREG 


FF48:28 






633 




PLP 




FF49:60 






634 


RTS6 


RTS 




FF4A: 






635 


* 






FF4A:85 


45 




636 


SAVE 


STA 


A5H ; 


FF4C:86 


46 




637 


SAV1 


STX 


XREG ; 


FF4E:84 


47 




638 




STY 


YREG 


FF50:08 






639 




PHP 




FF51:68 






640 




PLA 




FF52:85 


48 




641 




STA 


STATUS 


FF54:BA 






642 




TSX 




FF55:86 


49 




643 




STX 


SPNT 


FF57:D8 






644 




CLD 




FF58:60 






645 




RTS 




FF59: 






646 


* 






FF59:20 


8^ 


FE 


647 


OLDRST 


JSR 


SETNORM ; 


FF5C:20 


: ; F 


FB 


648 




JSR 


INIT ; 


FF5F:20 


93 


FE 


649 




JSR 


SETVID ; 


FF62:20 


88 


FE 


650 




JSR 


SETKBD 


FF65: 






651 


* 






FF65:D8 






652 


MON 


CLD 




FF66:20 


3A 


FF 


653 




JSR 


BELL ; 


FF69:A9 


AA 




654 


MONZ 


LDA 


#$AA ; 


FF6B:85 


3 3 




655 




STA 


PROMPT 


FF6D:20 


67 


FD 


656 




JSR 


GETLNZ ; 


FF70:20 


C7 


■rF 


657 




JSR 


ZMODE ; 


FF73:20 


A 7 


VV 


658 


NXTITM 


JSR 


GETNUM ; 


FF76:84 


34 




659 




STY 


YSAV ; 


FF78:A0 


1 7 




660 




LDY 


#$17 ; 


FF7A:88 






661 


CHRSRCH 


DEY 




FF7B:30 


E8 


FF65 


662 




BMI 


MON ; 


FF7D:D9 


CC 


FF 


663 




CMP 


CHRTBL.Y ; 


FF80:D0 


F8 


FF7A 


664 




BNE 


CHRSRCH ; 


FF82:20 


BE 


FF 


665 




JSR 


TOSUB ; 


FF85:A4 


34 




666 




LDY 


YSAV ; 


FF87:4C 


73 


FF 


667 




JMP 


NXTITM 


FF8A: 






668 


* 






FF8A:A2 


03 




669 


DIG 


LDX 


#303 


FF8C:0A 






670 




ASL 


A 


FF8D:QA 






671 




ASL 


A ; 


FF8E;0A 






672 




ASL 


A ; 


FF8F:0A 






673 




ASL 


A 


FF9O:0A 






674 


NXTBIT 


ASL 


A 


FF91 :26 


3E 




675 




ROL 


A2L 


FF93:26 


3F 




676 




ROL 


A2H 



MAKE A JOYFUL NOISE, THEN RETURN. 



RESTORE 6502 REGISTER CONTENTS 
USED BY DEBUG SOFTWARE 



;SAVE 6502 REGISTER CONTENTS 
FOR DEBUG SOFTWARE 



;SET SCREEN MODE 

AND INIT KBD/ SCREEN 
AS I/O DEVS. 



MUST SET HEX MODE! 

FWEEPER. 

**' PROMPT FOR MONITOR 

READ A LINE OF INPUT 

CLEAR MONITOR MODE, SCAN IDX 

GET ITEM, NON-HEX 

CHAR IN A-REG, 

X-R£G=0 IF NO HEX INPUT 

COMMAND NOT FOUND, BEEP & TRY AGAIN. 

FIND COMMAND CHAR IN TABLE 

NOT THIS TIME 

GOT IT! CALL CORRESPONDING SUBROUTINE 

PROCESS NEXT ENTRY ON HIS LINE 



;GOT HEX DIGIT, 
SHIFT INTO A2 






.- 



FF95 


:CA 




67 7 




DEX 




; LEAVE X=SFF If DIG 


FF96 


:10 


F8 FF9Q 


678 




BPL 


NXTBIT 






FF98 


:A5 


31 


679 


NXTBAS 


LDA 


MODE 






FF9A 


■DO 


06 FFA2 


680 




BNE 


NXTBS2 


;IF 


MODE IS ZERO, 


FF9C 


:B5 


3F 


681 




LDA 


A2H.X 


; THEN COPY A2 TO Al AND A3 


FF9E 


;95 


3D 


682 




ST A 


A1H.X 






FFAO 


:95 


41 


683 




STA 


A3H.X 






FF.42 


:E8 




684 


NXTBS2 


I NX 








FFA3 


:F0 


F3 FF98 


685 




BEO 


NXTBAS 






FFA5 


:DO 


06 FFAD 


686 




BNE 


NXTCHR 






FFA7 






687 


A 










FFA7 


:A2 


00 


688 


GETNUM 


LDX 


#$OQ 


; CLEAR A2 


FFA9 


:86 


iE 


689 




STX 


42 L 






FFAB 


:86 


3F 


690 




STX 


A2H 






FFAD 


:20 


FD FC 


691 


NXTCHR 


JSR 


UPMON ; 


let 


char, upshift, I NY 


FFBO 


:EA 




692 




NOP 




;im 


now done in UPMON 


FFB1 


:49 


BO 


693 




EOR 


#$BQ 






FFB3 


:C9 


OA 


694 




CMP 


#$GA 






FFB5 


:90 


D3 FF8A 


695 




BCC 


DIG 


;BR 


IF HEX DIGIT 


FFB7 


:69 


88 


696 




ADC 


#$88 






FFB9 


:C9 


FA 


697 




CMP 


#5 FA 






FFBB 


;4C 


IB FF 


698 




JMP 


LOOKASC ; 


:heck for ASCII Input 


FFBE 






699 


* 










FFBE 


:A9 


FE 


700 


TO SUB 


LDA 


*<G0 


-.niSPATCH TO SUBROUTINE, BY 


FFCO 


:48 




701 




PHA 




; PUSHING THE HI-ORDER SUBR ADDR, 


FFC1 


:B9 


E3 FF 


702 




LDA 


SUBTBL,Y 


; THEN THE LO-ORDER SUBR ADDR 


FFC4 


48 




703 




PHA 




; ONTO THE STACK, 


FFC5 


:A5 


31 


704 




LDA 


MODE 


; (CLEARING THE MODE, SAVE THE OL 


FFC7 


AO 


00 


705 


ZMODE 


LDY 


#$00 


; MODE IN A-REG), 


FFC9 


84 


31 


706 




STY 


MODE 






FFCB 


60 




707 




RTS 




; AND 'RTS' TO THE SUBROUTINE! 


FFCC 






708 


* 










FFCC 


BC 




709 


CHRTBL 


DF6 


$BC 


;"C 


(BASIC WARM START) 


FFCD 


B2 




710 




DFB 


SB2 


"Y 


(USER VECTOR) 


FFCE 


BE 




711 




DFB 


$BE 


;~E 


(OPEN AND DISPLAY REGISTERS) 


FFCF 


9A 




712 




DFB 


$9A 


i 


(enter mini-assembler) 


FFDO 


EF 




713 




DFB 


SEF 


;v 


(MEMORY VERIFY) 


FFM 


C4 




714 




DFB 


$C4 


"K 


(IN#SLOT) 


FFD2 


EC 




715 




DFB 


SEC 


;s 


(search for 2 bytes) 


FFD3 


A9 




716 




DFB 


$A9 


~ p 


(PR/fSLOT) 


FFD4 


33 




717 




DFB 


$£B 


~B 


(BASIC COLD START) 


FFD5 


AO 




718 




DFB 


$A6 


l _ r 


(SUBTRACTION) 


FFD6 


A4 




719 




DFB 


$A4 


'+' 


(ADDITION) 


FFD7 


J 6 




720 




DFB 


$06 


M 


(MEMORY MOVE) 


Ft" 118 


95 




721 




DFB 


595 


'<' 


(DELIMITER FOR MOVE, VFY) 


FFD9: 


07 




722 




DFB 


$07 


N 


(SET NORMAL VIDEO) 


FFDA 


02 




723 




DFB 


$02 


I 


(SET INVERSE VIDEO) 


FFDB: 


05 




724 




DFB 


$05 


L 


(DISASSEMBLE 20 INSTRS) 


FFDC: 


70 




725 




DFB 


SFO 


W 


(WRITE TO TAPE) 


[ 






726 




DFB 


$00 


G 


(EXECUTE PROGRAM) 


r 


EB 




727 




DFB 


$EB 


R 


(READ FROM TAPE) 




-■ 




728 




DFB 


$93 ; 


t * i 


(MEMORY FILL) 


JTz.1 ' 


&7 




729 




DFB 


$A7 


t i 


(ADDRESS DELIMITER) 


FFEl r 


:- 




730 




DFB 


$C6 ; 


'CR 


■ (END OF INPUT) 
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FFE2 
FFE3 

FFE3 
FFE3 
FFE3 
FFE3 
FFE4 
FFE5 
FFE6 
FFE7 
FFE8 
FFE9 
FFEA 
FFEB 
FFEC 
FFED 
FFEE 
FFEF 
FFFO 
FFF1 
FFF2 
FFF3 
FFF4 
FFF5 
FFF6 
FFF7 
FFF8 
FFF9 
FFFA 
FFFA 
FFFC 
FFFE 
0000 
0000 
0000 
0000 
0000 
0000 
C4C8 
C4C8 
C4C8 
C4CB 
C4CD 
C4D0 
C4D2 
C4D5 
C4D8 
C4DA 
C4DD 
C4DF 
C4E1 
C4E3 
C4E5 



99 



B2 
C9 

8E 
FO 
35 
SC 

D6 
96 

AF 
1? 
L7 
2B 
IF 
83 
7F 
5D 
CC 
85 
FC 
17 
17 
F5 
03 



FB 03 
62 FA 

FA C3 



C4CB 

20 13 FF 

84 34 

DD B4 F9 

DO 13 C4E5 

20 13 FF 

DD BA F9 

FO OD C4E7 

BD BA F9 

FO 07 C4E6 

C9 A4 

FO 03 

A4 34 

18 

88 



C4E6 



731 
732 
733 
734 
735 
736 
737 
738 
739 
740 
741 
742 
743 
744 
745 
746 
747 
748 
749 
750 
751 
752 
753 
754 
755 
756 
757 
758 
759 
760 
761 
762 
19 
1 
2 
3 
4 

6 

7 

3 

9 

10 

1 I 

u 

13 
14 
15 
16 

17 
18 
19 

20 
2! 



DFB S99 



; BLANK 



* Table of low order monitor routine dispatch 

* addresses. High byte always SFE 



SUBTBL 



DFB 


>8ASC0NT-l 


;"c 


(BASIC warm start) 


DFB 


>USR-1 


*T 


(not used) 


DFB 


>REGZ-1 


*E 


(open and display registers) 


DFB 


>M1NI-1 


mini 


assembler 


DFB 


>VFY-1 


V 


(memory verify) 


DFB 


>INPRT-1 


"K 


CIS* SLOT) 


DFB 


> SEARCH- 1 


sear 


-h for pattern 


DFB 


>OUTFRT-l 


-p 


(PR#SLOT) 


DFB 


>XBASIC-1 


*B 


(BASIC cold start) 


DFB 


>SETMODE-l 


, t _ 1 


(subtraction) 


DFB 


>SETMODE-l 


; ' + ' 


(addition) 


DFB 


>MOVE-l 


M 


(memory move) 


DFB 


>LT-1 


'<' 


(delim for move,vfy) 


DFB 


>SETNORM-l 


;N 


(set normal video) 


DFB 


>SETINV-1 


I 


(set inverse video) 


DFB 


>LIST-1 


L 


(disassemble 20 instrs) 


DFB 


>WRITE-1 


w 


(write to tape) 


DFB 


>GO-l 


G 


(execute program) 


DFB 


>READ-1 


,R 


(read from tape) 


DFB 


>SETMODE-i 


» 1 * 1 


(memory fill) 


DFB 


>SETMODE-l 


. ' ' 


(address delimiter) 


DFB 


>CRMON-l 


'CR' 


(end of input) 


DFB 


>BLANK-1 
NMI 


; BLANK 


DW 


;NON 


-MASKABLE INTERRUPT VECTOR 


DM 


RESET 


; RE SET VECTOR 


DW 


IRQ 


; INTERRUPT REQUEST VECTOR 






INCLUDE MINI 
* 

* Apple //e Mini Assembler 

* Got mnemonic, check address mode 
C30RG+S1C8 



AM0D1 



AMOD2 
AM0D4 



ORG 

JSR 
STY 
CMP 
BNE 
JSR 
CMP 
BEO. 
LDA 
BEO 
CMP 
BEQ 
LDY 
CLC 
DEY 



NNBL 

YSAV 

CHAR1.X 

AM0D2 

NNBL 

CHAR2 , X 

AM0D3 

CHAR2.X 

AM0D4 

#SA4 

AMOD4 

YSAV 



;get next non-blank 
;save Y 



;get next non-blank 

;done yet? 

;if "S" then done 

;restore Y 









C4E7 


26 


44 




22 


AM0D3 


ROL 


A5L 


;shift bit into format 


C4E9 


EO 


3 




2 3 






CPX 


#$03 




C4EB 


DO 


00 


C4FA 


24 






BNE 


AMOD6 




C4ED 


20 


A7 


FF 


25 






JSR 


GETNUM 




C4F0 


A5 


3F 




26 






LDA 


A2H 


;get high byte of address 


C4F2 


FO 


01 


C4F5 


27 






BEQ 


AMOD5 


;=> 


C4F4 


6* 






28 






I NX 






C4F5 


86 


35 




20 


AM0D5 


STX 


YSAV1 




C4F7 


A2 


03 




30 






LDX 


#$03 




C4F9 


88 






01 






DEY 






C4FA 


86 


3D 




32 


AM0D6 


STX 


A1H 




C4FC 


CA 






33 






DEX 






C4FD 


10 


C9 


C4C8 


34 






BPL 


A.MOD1 




C4FF 


60 






3 5 






RTS 






C500 








36 


* 










CF3A 






CF3A 


3 7 






ORG 


C80RG+S73A 




CF3A 








38 


* 










CF3A 








39 


* 


Calcu 


late 


offset byte 


for relative addresses 


CF3A 








40 


* 










CF3A 


E9 


81 




41 


REL 


SBC 


#$81 


;calc relative address 


CF3C 


46 






42 






LSR 


A 




CF3D 


DO 


u 


CF53 


43 






BNE 


GOERR 


;bad branch 


CF3F 


A4 


3F 




44 






LDY 


A2H 




CF41 


A6 


3E 




45 






LDX 


A2L 




CF43 


DO 


01 


CF46 


46 






BSE 


REL1 




CF45 


3? 






47 






DEY 




jpoint to offset 


CF46 


CA 






48 


REL1 


DEX 




;displacement - 1 


CF47 


^A 






-9 






TXA 






CF46 


18 






50 






CLC 






CF49 


25 


3 A 




51 






SBC 


PCL 


^subtract current PCL 


CF4E 


85 


32 




02 






STA 


A2L 


;and save as displacement 


CF4D 


1 


01 


CF50 


53 






BPL 


REL2 


; check page 


CF4F 


CS 






54 






I NY 






CF50 


98 






55 


REL2 


TYA 




;get page 


CF51 


E5 


J 1 -; 




56 






SBC 


PCH 


;check page 


CF53 


DO 


40 


CF95 


37 


GO ERR 


BNE 


M1NIERR 


;display error 


CF55 








58 


* 










CF55 








59 


■k 


Move 


instruction to memory 


CF55 








60 


■k 










CF55 


Ai 


2F 




61 


MOVINS1 


LDY 


LENGTH 


;get instruction length 


CF57 


BO 


3D 


00 


62 


MOV1 


LDA 


A1H.Y 


;get a byte 


CF5A 


91 


3 A 




63 






STA 


(PCL),Y 


;and move it 


CF5C 


88 






64 






DEY 






CF5D 


LO 


F8 


CF57 


65 






BPL 


MOV1 




CF5F 








3- 


* 










CF5F 








6 7 


* 


Displ 


ay instruction 




CF5F 








68 


* 










CF5F 


20 


48 


29 


69 






JSR 


PRBLNK 


; print blanks to make Pro 


CF62 


20 


; k 


FC 


7 






JSR 


UP 


;move up 2 lines 


CF65 


20 


LA 


22 


71 






JSR 


UP 




CF68 


4C 


E3 


FC 


72 






JMP 


DISLIN 


;disassemble it, =>DOINST 


CF6B 








7 3 


* 










CFoB 








74 


* 


Compare disassembly o 


f all known opcodes with 


CF6B 








75 


•n 


the one ty 


ped in until a match is found 






■ 



CF6B 
CF6B 
CF6D 
CF70 
CF71 
CF74 
CF76 
CF78 
CF7B 
CF7D 
CF7F 
CF81 
CF83 
CF85 
CF87 
CF89 
CF8B 
CF8D 
CF8F 
CF91 
CF93 
CF95 
CF95 
CF95 
CF95 
CF95 
CF97 
CF98 
CF99 
CF9C 
CF9C 
CF9C 
CF9C 
CF9C 
CF9C 
CF9F 
CFA2 
CFA4 
CFA6 
CFA8 
CFAA 
CFAB 
CFAB 
CFAE 
CFBO 
CFB2 
CFB3 
CFB5 
CFB5 
CFB8 
CFBA 
CFBC 
CFBF 
CFCO 



A3 3D 

20 8E F8 

AA 

BD 00 FA 

C5 42 

DO 13 CF8B 

BD CO F9 

C5 43 

DO OC CF8B 

A5 44 

A4 2E 

CO 9D 

FO B3 CF3A 

C5 2E 

FO CA CF55 

C6 3D 

DO DC 

E6 44 

C6 35 

FO D6 



CF6B 



CF6B 



A4 34 

98 

AA 

4C D2 FC 



20 C7 FF 
AD 00 02 
C9 AO 
FO 12 
C9 8D 
DO 01 
60 



CFB8 



CFAB 



20 A7 FF 
C9 93 

DO E5 CF97 

8A 

FO E2 CF97 

20 78 FE 
A9 03 
35 3D 
20 13 FF 
OA 
E9 BE 



76 
77 
78 
79 
80 
81 
S 2 

83 

Si 
85 

86 
87 

*r 

r<? 

90 

91 

92 

93 

94 

95 

9b 

97 

58 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

111 

112 

113 

114 

115 

116 

117 

118 

119 

120 

121 

122 

123 

124 

125 

1 2 ft 

127 

128 

129 



GETOP LDA A1H ;get opcode 

;determine mnemonic index 

;X = index 
;get right half of index 
;does it match entry? 
;=>try next opcode 
;get left half of index 
;does it match entry? 
;=>no, try next opcode 
jfound opcode, check address mode 
;get addr. mode format for that opcode 
;is it relative? 
;=>yes, calc relative address 
;does mode match? 

;=>yeSj move instruction to memory 
A1H ;else try next opcode 
;=>go try it 
;else try next format 

;=>go try next format 

Point to the error with a caret, beep, and fall 
into the mini-assembler. 



LDA 


A1H 


JSR 


INSDS2 


TAX 




LDA 


MNEMR.X 


CMP 


A4L 


BNE 


NXT0P 


LDA 


MNEML , X 


CMP 


A4H 


BNE 


NXTOP 


LDA 


A5L 


LDY 


FORMAT 


CPY 


//59D 


BEQ 


REL 


CMP 


FORMAT 


BEQ 


MQVINST 


DEC 


A1H 


BNE 


GETOP 


INC 


A5L 


DEC 


YSAVi 


BEQ 


GETOP 



M1N1ERF LDY 

ERR2 TYA 

TAX 

JMP 



YSAV 



ERR3 



;get position 



;display error, =>D0INST 






* Read a line of input. If prefaced with " , decode 

* mnemonic. If "S" do monitor command. Otherwise parse 

* hex address before decoding mnemonic. 



D0INST 



GET 1 1 

GOERR2 



D0LIN 
NXTCH 



JSR ZMODE ;clear mode 

LDA $200 ;get first char in line 

CMP #$A0 ;if blank, 

BE0 DOLIN ;=>go attempt disassembly 

CMP #$80 ;is it return? 

BNE GETI1 ;=>no, continue 

RTS ;else return to Monitor 

JSR GETNUM ;parse hexadecimal input 

CMP #393 ;look for "ADDR:" 

BNE ERR2 ;no ":", display error 

TXA ;X nonzero if address entered 

BEQ ERR2 ;no "ADDR", display error 

JSR A1PCLP ;move address to PC 

LDA #S03 ;get starting opcode 

STA A1H ;and save 

JSR NNBL jget next non-blank 

ASL A ^validate entry 

SBC #$BE 










CFC2:C9 

CFC4:90 

CFC6: 

CFC6: 

CFC6: 

CFC6:0A 

CFC7:0A 

CFC8:A2 

CFCA:OA 

CFCB:26 

CFCD:26 

CFCF:CA 

CFD0:10 

CFD2:C6 

CFD4:F0 

CFD6:10 

CFD8: A2 

CFDA:20 

CFDD:A5 

CFDFsOA 

CFEO:OA 

CFEH05 

GFE3:C9 

CFE5;BO 

CFE7:A6 

CFE9:F0 

CFEB:09 

CFED:85 

CFEF:84 

CFF1:B9 

CFF4:C9 

CFF6:FO 

CFF8:C9 

CFFA:DO 

CFFC:4C 

CFFF: 

CFFF:0O 



C2 

Dl 



CF97 



CFCA 

CFCA 
CFBC 



04 
42 

43 

P8 
3D 

F4 
E4 
05 
C8 C4 

44 



35 

20 

06 CFED 

35 

02 CFED 

80 

44 

34 

00 02 

BB 

04 CFFC 

8D 

B4 CFBO 

6B CF 



130 

131 
132 

133 

134 * 

133 

136 

137 

138 NXTMN 

139 

140 

Ul 

142 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 AM0D7 

158 

159 

160 

161 

162 

163 

164 AM0D8 

165 * 
166 



CMP #SC2 

BCC F,RR2 ;=>flflg bad mnemonic 

Form mnemonic for later comparison 



ASL 
ASL 
LDX 
ASL 
ROL 
ROL 
DEX 
BPL 
DEC 
BEQ 
BPL 
LDX 
JSR 
LDA 
ASL 
ASL 
ORA 
CKP 
BCS 
LDX 
BEQ 
ORA 
STA 
STY 
LDA 
CMP 
BEQ 
CMP 
BNE 
JMP 



A 
A 
#$04 

A 

A4L 
A4H 

NXTMN 

A1H 

NXTMN 

NXTCH 

ff$5 

AMOD1 

A5L 

A 

A 

YSAV1 

#$20 

AMOD7 

YSAV1 

AMOD7 

#$ao 

A5L 

YSAV 

$0200,Y 

#$BB 

AM0D8 

#$8D 

GOERR2 

GETOP 



DFB $00 



rdecrement mnemonic count 



index into address mode tables 
do this elsewhere 
get format 



;get our format 

;update format 
;update position 
;get neKt character 
;is it a ";"? 
;=>yes, skip comment 
;is it carriage return 

;get next opcode 

;byte for making CTQD checksum ok 



Appendix I: Monitor ROM Listings 



;?T5 



Glossary 



accumulator: The register in the 
65C02 microprocessor where most 
computations are performed. 

ACIA: Acronym for Asychronous 
Communica tions Interface 
Adapter. The ACIA is a chip that 
converts data from parallel to serial 
form and vice versa. Its internal 
registers control and keep track of 
the sending and receiving of data. 
Firmware and software set and 
change the status of these internal 
registers. 

acronym: A word formed from the 
initial letters of a name or phrase, 
such as ROM, from read-only 
memory. 

address: A number that specifies a 
single byte of memory. Addresses 
can be given as decimal integers or 
as hexadecimal integers. A 64K 
system has addresses ranging from 
to 65535 (in decimal) or from 
$0000 to $FFFF (in hexadecimal). 

algorithm: A step-by-step 
procedure for solving a problem or 
accomplishing a task. 

analog: Represented in terms of a 
physical quantity that can vary 
smoothly and continuously over a 



range of values. For example, a 
conventional 12-hour clock face is 
an analog device that represents the 
time of day in terms of the angles of 
the clock's hands. Compare digital. 

analog data: Data in the form of 
continuously variable physical 
quantities. Compare digital 
data. 

analog signal: A signal that varies 
continuously over time. 

analog-to-digital converter: A 

device that converts quantities from 
analog to digital form, For example, 
hand controls used on Apple II 
family computers convert the 
position of the control dial (an 
analog quantity) into a discrete 
number (a digital quantity) that 
changes abruptly even when the 
dial is turned smoothly. 

AND: A logical operator that 
produces a true result if both of its 
operands are true, a false result if 
either or both of its operands are 
false; compare OR, exclusive OR, 
NOT 

ANSI: Acronym (or American 
National Standards Institute, 
which sets standards for many 
fields and is the most common 
standard for terminals. 



Apple lie: A transportable 
personal computer in the Apple II 
family, with a disk drive and 
80-column capability built in. 

Apple He: A personal computer in 
the Apple II family. 

Apple lie 80-Column Text Card: 

A peripheral card that plugs into the 
Apple lie's auxiliary slot and 
converts the computer's display of 
text from 40-column width to 
80-column width. 

Apple lie Extended 80-Column 
Text Card: A peripheral card that 
plugs into the Apple lie's auxiliary 
slot and converts the computer's 
display of text from 40-column 
width to 80-column width while 
extending its memory capacity by 
64K bytes. 

Apple II Pascal: A software 
system that lets you create and 
execute programs written in the 
Pascal programming language, 
adapted by Apple Computer from 
the UCSD (University of California, 
San Diego) Pascal Operating System 
and sold for use with the Apple II 
family of computers. 
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Applesoft BASIC: An extended 
version of the BASIC programming 
language used with the Apple II 
family of computers. An interpreter 
for creating and executing programs 
in Applesoft is built into the 
computer's firmware. Compare 
Integer BASIC 

application program: A program 
that puts the resources and 
capabilities of the computer to use 
for some specific purpose or task, 
such as word processing, data base 
management, or graphics. Compare 
system program. 

argument: The value on which a 
function operates. 

arithmetic expression: A 

combination of numbers and 
arithmetic operators (such as 
3 + 5) that indicates some operation 
to be carried out. 

arithmetic operator: An 

operator, such as +, that combines 
numeric values to produce a 
numeric result. Compare 
relational operator, logical 
operator 

ASCII: Acronym for American 
Standard Code for Information 
Interchange, pronounced ASK ee. 

A code in which the numbers from 



to 127 stand for text characters- 
including the letters of the alphabet, 
the digits through 9, punctuation 
marks, special characters, and 
control characters— used for 
representing text inside a computer 
and for transmitting text between 
computers or between a computer 
and a peripheral device. 

assembler: A language translator 
that converts a program written in 
assembly language into an 
equivalent program in machine 
language. 

assembly language: A low level 
programming language in which 
individual machine-language 
instructions are written in a 
symbolic form more easily 
understood by a human programmer 
than machine language itself. 

asserted: Made true (positive in 
positive-true logic; negative in 
negative-true logic). 

asynchronous transmission: 

Not synchronized by or with a 
clocking signal. Transmission in 
which each information character is 
individually synchronized, usually 
by the use of start and stop bits. The 
gap between each character isn't 
necessarily fixed, Compare 
synchronous transmission. 



auxiliary slot: The special 
expansion slot inside the Apple He 
used for the Apple 80-Column Text 
Card or Extended 80-Column Text 
Card. 

base address: In indexed 
addressing, the fixed component of 
an address. 

BASIC: Acronym for Beginner's 

All-purpose Symbolic Instruction 
Code, A high-level programming 
language designed to be easy to 
learn and use. Two versions of 
BASIC are available from Apple 
Computer for use with all Apple II 
family systems: Applesoft (built into 
firmware) and Integer BASIC 
(provided on the ProDOS User's 
Disk). 

baud: Unit of signaling speed taken 
from the name Baudot. The speed in 
bauds is equal to the number of 
discrete conditions or signal events 
per second regardless of the 
information content of those signals. 
Often equated (though not 
precisely) with bite per second. 
Compare bit rate. 
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binary: The representation of 
numbers in terms of powers of two, 
using the two digits and 1. 
Commonly used in computers 
because the values and 1 can 
easily be represented in physical 
form in a variety of ways, such as 
the presence or absence of current, 
positive or negative voltage, or a 
white or black dot on the display 
screen. A single binary digit— a or 
a 1— is called a bit. 

binary digit: The smallest unit of 
information in the binary number 
system. Also called a bit. 

binary operator: An operator that 
combines two operands to produce a 
result; for example, + is a binary 
arithmetic operator, < is a binary 
relational operator, and OR is a 
binary logical operator. Compare 
unary operator. 

bit: The smallest item of useful 
information a computer can handle. 
Usually represented as a 1 or a 0. 
Eight bits equal one byte. 

bit rate: The speed at which bits 
are transmitted, usually expressed 
as bps or bits per second. 
Compare baud. 

board: See printed-circuit 
board. 



body: The statements or 
instructions that make up a part of a 
program, such as a loop or a 
subroutine. 

boot: To start up a computer by- 
loading a program into memory 
from an external storage medium 
such as a disk. Often accomplished 
by first loading a small program 
whose purpose is to read the larger 
program into memory. The program 
is said to pull itself up by its own 
bootstraps— hence the term 
bootstrapping or booting. 

boot disk: See startup disk. 

bootstrap: See boot. 

bps: See bit rate 

branch: To send program 
execution to a line or statement 
other than the next in sequence. 

BREAK: A SPACE (0) signal sent 
over a communication line, of long 
enough duration to interrupt the 
sender. This signal is often used to 
end a session with a time-sharing 
service. 

BRK: An instruction that causes 
the 65C02 microprocessor to halt. 



buffer: A memory area that holds 
information until it can be 
processed. 

bug: An error in a program that 
causes it not to work as intended. 

bus: A group of wires that transmit 
related information from one part of 
a computer system to another. 

byte: A sequence of eight bits that 
represents an instruction, a letter, a 
number, or a punctuation mark. 

cable: A group of wires used to 
carry information between two 
devices. How many wires are used 
varies with the type of connection. 

call: To request the execution of a 
subroutine or function. 

card: See peripheral card. 

carriage return: An ASCII 
character (decimal 13) that 
ordinarily causes a printer or 
display device to place the 
subsequent character on the left 
margin. 

carrier: The background signal on 
a communication channel that is 
modified to carry the information. 
Under RS232-C rules, the carrier 
signal is equivalent to a continuous 
MARK (1) signal; a transition to 
then represents a start bit. 
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carry flag: A status bit in the 
65C02 microprocessor, used to hold 
the high-order bit (the carry bit) in 
addition and subtraction, 

central processing unit: See 
processor. 

character: Any symbol that has a 
widely understood meaning. Some 
characters— such as letters, 
numbers, and punctuation— can be 
displayed on the monitor screen and 
printed on a printer. Others are used 
to control various functions of the 
computer. See control character. 

character code: A number used to 
represent a text character for 
processing by a computer system. 

character set: The entire set of 
characters that can be either shown 
on a monitor or used to code 
computer instruction. In a printer, 
the entire set of characters that the 
printer is capable of printing. 

circuit board: A collection of 
integrated circuits (chips) on a 
board. 

Clear To Send: An ES232-C signal 
from a DCE to a DTE that is 
normally kept false until the DCE 
makes it true, indicating that all 
circuits are ready to transfer data 
out. 



code: (1) A number or symbol used 
to represent some piece of 
information in a compact or easily 
processed form. (2) The statements 
or instructions making up a 
program. 

cold start: The process of starting 
up the Apple II when the power is 
first turned on (or as if the power 
had just been turned on) by loading 
the operating system into main 
memory, then loading and running a 
program. 

column: A vertical arrangement of 
graphics points or character spaces 
on the monitor screen. 

command: A word or character 
that causes the computer to do 
something. 

compiler: A language translator 
that converts a program written in a 
high-level programming language 
into an equivalent program in some 
lower-level language (such as 
machine language) for later 
execution. Compare interpreter. 

composite video: A video signal 
that includes both display 
information and the synchronization 
(and other) signals needed to 
display it. 



computer: An electronic device 
that performs predefined 
(programmed) computations at high 
speed and with great accuracy. A 
machine that is used to store, 
transfer, and transform information. 

computer language: See 
programming language. 

computer system: A computer 
and its associated hardware, 
firmware, and software. 

conditional branch: A branch 
that depends on the truth of a 
condition or the value of an 
expression. Compare 
unconditional branch. 

configuration: The hardware and 
software arrangement of a system. 

connector: A physical device such 
as a plug, socket, or jack, used to 
connect two devices to one another. 

console: The Apple He's video 
display and keyboard together make 
up the console. This is the part of 
the Apple lie you communicate with 
directly. 

constant: A symbol in a program 
that represents a fixed, unchanging 
value. Compare variable. 
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control | : A key that when 



pressed in conjunction with another 
key makes that other key behave 
differently. 

I CONTROL jf RESET j : This 

combination of keystrokes usually 
causes an Applesoft program or 
command to stop immediately. If a 
program disables the 
I control H reset | feature, you 
need to turn the computer off to get 
the program to stop. 

control character: A non-printing 
character that controls or modifies 
the way information is printed or 
displayed. Control characters have 
ASCII values between and 31, and 
are typed from a keyboard by 
holding down I control I while 
pressing some other key. For 
example, the character Control-M 
(ASCII code 13) means "return to 
the beginning of the line" and is 
equivalent to pressing return | . 

control code: One or more 
non-printing characters included in 
a text file whose function is to 
change the way a printer prints the 
text, See control character. 



controller card: A peripheral card 
that connects a device such as a 
printer or disk drive to an Apple lie 
and controls the operation of the 
device, 

copy-protect: To prevent someone 
from duplicating the contents of a 
disk. Compare write-protect 

CPU: Abbreviation for central 
processing unit. See processor, 

current input device: The source, 
such as the keyboard or a modem, 
from which a program is currently 
receiving its input. 

current output device: The 

destination, such as the display 
screen or a printer, to which a 
program is currently sending its 
output. 

cursor: A symbol displayed on the 
screen that marks where the user's 
next action will take effect or where 
the next character typed from the 
keyboard will appear. 

DAC: See digital-to-analog 
converter. 

data: Information, especially raw 
or unprocessed information, used or 
operated on by a program. 



data bits: The computer sends 
and receives information as a string 
of bits. These are called data bits. 

Data Carrier Detect: An RS232-C 
signal from a DCE (such as a 
modem) to a DTE (such as an 
Apple lie) indicating that a 
communication connection has 
been established. 

Data Communication 
Equipment: As defined by the 
RS232-C standard, any device that 
transmits or receives information. 
Usually this is a modem. However, 
when a modem eliminator is used, 
the Apple He itself looks like a DCE 
to the other device, and the other 
device looks like a DCE to the 
Apple He. 

data set: A device that performs 
the modulation/demodulation 
control functions necessary to 
provide the compatibility between 
business machines and 
communications facilities. See 
modem 

Data Set Ready: AnRS232-C 

signal from a DCE to a DTE 
indicating that the DCE has 
established a connection. 
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Data Terminal Equipment: As 

defined by the RS232-C standard, 
any device that generates or absorbs 
information, thus acting as a 
terminus of a communication 
connection. 

Data Terminal Ready: An 

RS232-C signal from a DTE to a DCE 
indicating a readiness to transmit or 
receive data. 

DCD: See Data Carrier Detect. 

DCE: See Data Communication 
Equipment. 

debug: To locate and correct an 
error or the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
software-related problems. Compare 
troubleshoot. 

decimal: The common form of 
number representation used in 
everyday life, in which numbers are 
expressed in terms of powers of ten, 
using the ten digits through 9. 

default: A value, action, or setting 
that is assumed or set in the 
absence of explicit instructions 
otherwise. 



deferred execution: The saving 
of an instruction in a program for 
execution at a later time as part of a 
complete program; occurs when the 
statement is typed with a line 
number. Compare immediate 
execution. 



] delete | : A key on the upper-right 
corner of the Apple He and He 
keyboards that, when pressed, 
usually erases the character 
immediately preceding the cursor. 

delimiter: A character that is used 
to mark the beginning or end of a 
sequence of characters, and which 
therefore is not considered part of 
the sequence itself. For example, 
Applesoft uses the double quotation 
mark (") as a delimiter for string 
constants: the string DOG consists 
of the three characters A 0, and G, 
and does not include the quotation 
marks. In written English, the space 
character is used as a delimiter 
between words. 

demodulate: To recover the 
information being transmitted by a 
modulated signal; for example, a 
conventional radio receiver 
demodulates an incoming broadcast 
signal to convert it into sound 
emitted by a speaker. 



device: A piece of computer 
hardware— such as a disk drive, a 
printer, or a monitor— other than 
the computer itself. Devices may be 
built in or peripheral. 

device driver: A program that 
manages the transfer of information 
between the computer and a 
peripheral device. 

device handler: See device 
driver. 

digit: (1) One of the characters 
through 9, used to express numbers 
in decimal form. (2) One of the 
characters used to express numbers 
in some other form, such as and 1 
in binary or through 9 and A 
through F in hexadecimal. 

digital: Represented in a discrete 
(noncontinuous) form, such as 
numerical digits. For example, 
contemporary digital clocks display 
the time in numerical form (such as 
2:57) instead of using the positions 
of a pair of hands on a clock face. 
Compare analog. 

digital data: Data that can be 
represented by digits— that is, data 
that are discrete rather than 
continuously variable. Compare 
analog data. 
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digital-to-analog converter: A 

device that converts quantities from 
digital to analog form. 

DIP: See dual in-line package. 

DIP switch: A bank of tiny 
switches, each of which can be 
moved manually one way or the 
other to represent one of two values 
(usually on and off). 

disassembler: A language 
translator that converts a 
machine-language program into an 
equivalent program in assembly 
language, more easily understood by 
a human programmer, The opposite 
of an assembler. 

disk: An information-storage 
medium consisting of a flat, 
circular, magnetic surface on which 
information can be recorded in the 
form of small magnetized spots, in a 
manner similar to the way sounds 
are recorded on tape. 

disk controller card: A circuit 
board that provides the connection 
between one or two disk drives and 
the Apple lie. 

disk drive: A device that reads 
information from disks into the 
memory of the computer and writes 
information from the memory of the 
computer onto a disk. 



disk envelope: A removable 
protective paper sleeve used when 
handling or storing a disk. It must be 
removed before inserting the disk in 
a disk drive. Compare disk jacket. 

diskette: A term sometimes used 
for the small (5^-inch), flexible 
disks on which information is 

stored, 

disk jacket: A permanent 
protective covering for a disk, 
usually made of black paper or 
plastic. The disk is never removed 
from the jacket, even when inserted 
in a disk drive. Compare disk 
envelope. 

disk operating system: One of 

several optional software systems 
for the Apple II family of computers 
that enables the computer to control 
and communicate with one or more 
disk drives. 

Disk II drive: One of a number of 
types of disk drive made and sold by 
Apple Computer for use with the 
Apple II family of computers. It uses 
5^-inch flexible (floppy) disks. 

disk-resident: Stored or held 
permanently on a disk. 



display: v. To exhibit information 

visually, n. (1) Information 
exhibited visually, especially on the 
screen of a display device, such as a 
video monitor, (2) A display device. 

display color: The color currently 
being used to draw high-resolution 
or low-resolution graphics on the 
display screen. 

display device: A device that 
exhibits information visually, such 
as a television set or video monitor. 

DOS 3.2: An early Apple II 
operating system. DOS stands for 
Disk Operating System. 3.2 is the 
version number. 

DOS 3.3: One of the operating 
systems used by the Apple II family 
of computers. DOS stands for Disk 
Operating System. 3.3 is the 
version number. 

drive: See disk drive. 

DSR: See Data Set Ready. 

DTE: See Data Terminal 
Equipment. 

DTR: See Data Terminal Ready. 
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dual in-line package: An 

integrated circuit packaged in a 
narrow rectangular box with a row 
of metal pins along each side. Often 
referred to as a DIP switch, 

Dvorak keyboard: An alternate 
keyboard layout, also known as the 
simplified keyboard. 

effective address: In 

machine-language programming, 
the address of the memory location 
on which a particular instruction 
actually operates, which may be 
arrived at by indexed addressing or 
some other addressing method. 

80-coIumn text card: A circuit 
board that converts the computer's 
display of text from 40 columns to 
80 columns. 

80/40 column switch: A switch, 
either hardware or software, that 
controls the number of horizontal 
columns or characters across your 
screen. A television can display a 
maximum of 40 characters across, 
while a video monitor can display 80 
characters across the screen. 

embedded: Contained within. For 
example, the string 
humpty dumpty is said to contain 
an embedded space. 



emulate: To behave in an identical 
way. The Apple II 2780/3780 
Protocol Emulator and the Apple II 
3270 BSC Protocol Emulator, for 
example, allow your Apple II, II 
Plus, or He, together with the Apple 
Communications Protocol Card 
(ACPC), to emulate the operations 
of IBM 3278 and 3277 terminals and 
3274 and 3271 control units. 

end-of-command mark: A 

punctuation mark used to separate 
commands sent to a peripheral 
device such as a printer or plotter. 
Also called a command 
terminator. 

end-of-line character: Any 

character that tells the printer that 
the preceding text constitutes a full 
line and may now be printed. 

error code: A number or other 
symbol representing a type of error. 

error message: A message 

displayed or printed to notify the 
user of an error or problem in the 
execution of a program. 

Escape character: An ASCII 

character that allows you to perform 
special functions when used in 
combination keypresses. 



escape mode: A state of the 
computer, entered by pressing 
I esc I , in which certain keys on the 
keyboard take on special meanings 
for positioning the cursor and 
controlling the display of text on the 
screen. 

escape sequence: A sequence of 
keystrokes, beginning with [esc], 
used for positioning the cursor and 
controlling the display of text on the 
screen. 

even parity: Use of an extra bit set 
to or 1 as necessary to make the 
total number of 1 bits (among the 
data bits plus the parity bit) an even 
number. 

even/odd parity check: A check 
that tests whether the number of 
digits in a group of binary digits is 
even (even parity check) or odd 
(odd parity check). 

exclusive OR: A logical operator 
that produces a true result if one of 
its operands is true and the other 
false, a false result if its operands 
are both true or both false. Compare 
OR, AND, and NOT. 

execute: To perform the actions 
specified by a program command or 
sequence of commands. 
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expansion slot: A connector 
inside the Apple He in which a 
peripheral card can be installed. 
Sometimes called a peripheral 
slot. 

expression: A formula in a 
program that describes a calculation 
to be performed. 

FIFO: First in, first out. 

file: An ordered collection of 
information stored as a named unit 
on a peripheral storage medium 
such as a disk. 

firmware: Software stored 
permanently in hardware: programs 
in read-only memory (ROM). Such 
programs (for example, the 
Applesoft Interpreter and the 
Monitor program) are built into the 
computer at the factory. They can 
be executed at any time but cannot 
be modified or erased from main 
memory. Compare hardware, 
software. 

fixed-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is considered to occur at a 
fixed position within the number. 
Typically, the point is considered to 



lie at the right end of the number so 
that the number is interpreted as an 
integer. Compare floating-point. 

flag: A variable whose contents 
(usually 1 or 0, standing for true or 
false) indicate whether some 
condition holds or whether some 
event has occurred. Used to control 
the program's actions at some later 
time. 

flexible disk: A disk made of 
flexible plastic. Often called a 
floppy disk. Compare rigid disk. 

floating-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is permitted to float to 
different positions within the 
number. Some of the bits within the 
number itself are used to keep track 
of the point's position. Compare 
fixed-point. 

floppy disk: See flexible disk. 

format: n. The form in which 
information is organized or 
presented, r (1) To specify or 
control the format of information. 
(2) To prepare a blank disk to 
receive information by dividing its 
surface into tracks and sectors. Also 
initialize, 



form feed: An ASCII character 
(decimal 12) that causes a printer or 
other paper-handling device to 
advance to the top of the next page. 

FORTRAN: A contraction of the 
phrase FORmula TRANslator. A 
widely used, high-level 
programming language especially 
suitable for applications requiring 
extensive numerical calculations, 
such as in mathematics, 
engineering, and the sciences. A 
version called Apple II Fortran is 
sold by Apple Computer for use with 
the Apple II Pascal Operating 
System. 

framing error: In serial data 
transfer, absence of the expected 
stop bit(s) at the end of a received 
character. 

frequency: The number of 
complete cycles transmitted per 
second. Usually expressed in hertz 
(cycles per second), kilohertz 
(kilocycles per second), or 
megahertz (megahertz per second). 

full duplex: Capable of 
simultaneous, two-way- 
communication. Compare half 
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function: A pre-programmed 
calculation that can be carried out 
on request from any point in a 
program. An instruction that 
converts data from one form to 
another. 

GAME I/O connector: A special 
16-pin connector inside the 
Apple lie originally designed for 
connecting hand controls to the 
computer, but also used for 
connecting some other peripheral 
devices. Compare hand-control 
connector. 

graphics: (1) Information 
presented in the form of pictures or 
images. (2) The display of pictures 
or images on a computer's video 
display screen. Compare text. 

half duplex: Capable of 
communication in only one 
direction at a time. Compare full 
duplex. 

hand-control connector: A 9-pin 
connector on the back panel of the 
Apple He, used for connecting hand 
controls to the computer. Compare 
GAME I/O connector. 



hand controls: Optional 
peripheral devices, with rotating 
dial and pushbuttons, that can be 
connected to the Apple He hand 
control connector. Typically used to 
control game-playing programs, but 
can be used in more serious 
applications as well. 

hang: For a program or system to 
spin its wheels indefinitely, 
performing no useful work. 

hardware: The physical 
machinery that makes up a 
computer system. Compare 
firmware, software. 

hertz: The unit of frequency of 
vibration or oscillation, also called 
cycles per second. Named for the 
physicist Heinrich Hertz and 
abbreviated Hz. The 65C02 
microprocessor used in the Apple lie 
operates at a clock frequency of 1 
million hertz, or 1 megahertz (MHz). 

hexadecimal: The representation 
of numbers in terms of powers of 
sixteen, using the ten digits 
through 9 and the six letters A 
through F. Hexadecimal numbers 
are easier for humans to read and 
understand than binary numbers, 
but can be converted easily and 
directly to binary form. Each 
hexadecimal digit corresponds to a 



sequence of four binary digits, or 
bits. Hexadecimal numbers are 
preceded by a dollar sign ($). 

high ASCII characters: ASCII 
characters with decimal values of 
128 to 255. Called high ASCII 
because their high bit (first binary 
digit) is set to 1 (for on) rather than 
OCforo/jQ. 

high-level language: A 

programming language that is 
relatively easy for humans to 
understand. A single statement in a 
high-level language typically 
corresponds to several instructions 
of machine language. High-level 
languages available for the Apple He 
include BASIC. Pascal, Logo, and 
PILOT. 

high-order byte: The more 
significant half of a memory address 
or other two-byte quantity. In the 
65C02 microprocessor, the low-order 
byte of an address is usually stored 
first, and the high-order byte 
second. 

high-resolution graphics: The 

display of graphics on a display 
screen as a six-color array of points, 
280 columns wide and 192 rows 
high, When the text window is in 
use, the visible high-resolution 
graphics display is 280 by 160 
points. 
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hold timet In computer circuits, 
the amount of time a signal must 
remain valid after some related 
signal has been turned off. Compare 
setup time. 

Hz: See hertz. 

IC: See integrated circuit. 

immediate execution: The 

execution of an program instruction 
as soon as it is typed. Occurs when 
the line is typed without a line 
number. This means that you can 
try out nearly every statement 
immediately to see how it works. 
Compare deferred execution. 

implement: To realize or bring 
about; for example, a language 
translator implements a particular 
language. 

IN#: This command designates 
the source of subsequent input 
characters. It can be used to 
designate a device in a slot or a 
machine-language routine as the 
source of input. 

index: (1) A number used to 
identify a member of a list or table 
by its sequential position. (2) A list 
or table whose entries are identified 
by sequential position, (3) In 
machine-language programming, 
the variable component of an 



indexed address, contained in an 
index register and added to the base 
address to form the effective 
address. 

indexed addressing: A method of 
specifying memory addresses used 
in machine-language programming. 

index register: A register in a 
computer processor that holds an 
index for use in indexed addressing. 
The 65C02 has two index registers, 
the X register and the Y register. 

index variable: A variable whose 
value changes on each pass through 
a loop. Often called control 
variable or loop variable. 

infinite loop: A section of a 
program that will repeat the same 
sequence of actions indefinitely. 

initialize: (1) To set to an initial 
state or value in preparation for 
some computation. (2) To prepare a 
blank disk to receive information by 
dividing its surface into tracks and 
sectors. Also format. 

initialized disk: A disk that is 
organized into tracks and sectors. 

input: Information transferred into 
a computer from some external 
source, such as the keyboard, a disk 
drive, or a modem. 



input/output: Abbreviated I/O, 
The means by which information is 
transferred between the computer 
and its peripheral devices. 

input routine: A 

machine-language routine that 
performs the reading of characters. 
The standard input routine reads 
characters from the keyboard. A 
different input routine might, for 
example, read them from an 
external terminal. 

instruction: A unit of a 
machine-language or 
assembly-language program 
corresponding to a single action for 
the computer's processor to 
perform. 

integer: A whole number 
represented inside the computer in 
fixed-point form. Compare real 
number. 

Integer BASIC: A version of the 

BASIC prograrnming language used 
by the Apple n family of computers. 
Integer BASIC is older than 
Applesoft and capable of processing 
numbers in integer (fixed-point) 
form only. Compare Applesoft 
BASIC. 
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integrated circuit: Networks of 
microfine wire that conduct 
electrical impulses. They are etched 
on silicon wafers and embedded in 
black plastic. 

interface: The devices, rules, or 
conventions by which one 
component of a system 
communicates with another. 

interface card: A peripheral card 
that implements a particular 
interface (such as a parallel or serial 
interface) by which the computer 
can communicate with a peripheral 
device such as a printer or modem. 

interpreter: A language translator 
that reads a program instruction by 
instruction and immediately 
translates each instruction for the 
computer to carry out. Compare 
compiler. 

interrupt: A temporary 
suspension in the execution of a 
program by a computer in order to 
perform some other task, typically 
in response to a signal from a 
peripheral device or other source 
external to the computer. 



inverse video: The display of text 
on the computer's display screen in 
the form of dark dots on a light (or 
other single phosphor color) 
background, instead of the usual 
light dots on a dark background. 

I/O: Input/output. The transfer of 
information into and out of a 
computer. See input, output. 

I/O device: Input/output device. 
A device that transfers information 
into or out of a computer. See input, 
output, peripheral device. 

I/O link: A fixed location that 
contains the address of an 
input/output subroutine in the 
computer's Monitor program. 

joystick: An accessory that moves 
creatures and objects in game 
programs. 

K: Two to the tenth power, or 1024 
(from the Greek root kilo, meaning 
one thousand); for example, 64K 
equals 64 times 1024, or 65,536. 

keyboard: The set of keys built 
into the Apple He, similar to a 
typewriter keyboard, used for 
entering information into the 
computer. 



keyboard input connector: The 

special connector inside the 
Apple He by which the keyboard is 
connected to the computer. 

keystroke: The act of pressing a 
single key or a combination of keys 
(such as I control KcTj on the 
keyboard. 

keyword: A special word or 
sequence of characters that 
identifies a particular type of 
statement or command, such as 
RUN ot PRINT. 

kilobyte: A unit of information 
consisting of IK (1024) bvtes, or 8K 
(8192) bits. See K. 

KSW: The symbolic name of the 
location in the computer's memory 
where the standard input link is 
stored. KSW stands for keyboard 
switch. See I/O link. 

language: See programming 
language. 

leading zero: A zero occurring at 
the beginning of a number, deleted 
by most computing programs. 

least significant bit: The 

right-hand bit of a binary number as 
written down. Its positional value is 
Oorl. 
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LIFO: Acronym for last in, first 
out. 

line feed: An ASCII character 
(decimal 10) that ordinarily causes 
a printer or video display to advance 
to the next line. 

line number: A number 
identifying a program line in an 
Applesoft program, Line numbers 
are necessary for deferred 
execution. 

line width: The number of 
characters that fit on a line on the 
screen or on a page. 

list: A verb in computer jargon, 
meaning to display on a monitor, or 
print on a printer, the contents of 
the computer memory or a file, 

load: To transfer information from 
a peripheral storage medium (such 
as a disk) into main memory for use; 
for example, to transfer a program 
into memory for execution. 

location: See memory location. 

logic board: See main logic 
board. 



logical operator: An operator, 
such as AND, that combines logical 
values to produce a logical result. 
Compare arithmetic operator, 
relational operator. 

loop: A section of a program that is 
executed repeatedly until a limit or 
condition is met, such as an index 
variable reaching a specified ending 
value. 

loop variable: See index 
variable, 

low-level language: A 

programming language that is 
relatively close to the form that the 
computer's processor can execute 
directly. Low-level languages 
available for the Apple lie include 
6502 machine language and 6502 
assembly language. 

low-order byte: The less 
significant half of a memory address 
or other two-byte quantity. In the 
65C02 microprocessor, the low-order 
byte of an address is usually stored 
first, and the high-order byte 
second. 

low-power Schottkey: A type of 

TTL integrated circuit having lower 
power and higher speed than a 
conventional TTL integrated circuit. 



low-resolution graphics: The 

display of graphics on a display 
screen as a sixteen-color array of 
blocks, 40 columns wide and 48 
rows high. When the text window is 
in use, the visible low-resolution 
graphics display is 40 by 40 blocks. 

LS: See low-power Schottkey. 

machine language: The form in 

which instructions to a computer 
are stored in memory for direct 
execution by the computer's 
processor. Each model of computer 
processor (such as the 65C02 
microprocessor used in the 
Apple He) has its own form of 
machine language. 

main logic board: A large circuit 
board that holds RAM, ROM, the 
microprocessor, custom-integrated 
circuits, and other components that 
make the computer a computer. 

main memory: The memory 
component of a computer system 
that is built into the computer itself 
and whose contents are directly 
accessible to the computer. 

MASK parity: A bit of value 1 
appended to a binary number for 
transmission. The receiving device 
can then check for errors by looking 
for this value on each character. 
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mask: A pattern of bits for use in 
bit-level logical operations. 

memory: A hardware component 
of a computer system that can store 
information for later retrieval. See 
main memory, random-access 
memory, read-only memory, 
read-write memory- 
memory location: A unit of main 
memory that is identified by an 
address and can hold a single item 
of information of a fixed size. In the 
Apple He, a memory location holds 
one byte, or eight bits, of 
information. 

memory-resident: (1) Stored 
permanently in main memory as 
firmware. (2) Held continually in 
main memory even while not in use. 
DOS is memory resident, 

menu: A list of choices presented 
by a program, usually on the display 
screen, from which the user can 

select. 

MHz: Megahertz; one million hertz. 
See hertz. 

microcomputer: A computer, 
such as any of the Apple II family of 
computers, whose processor is a 
microprocessor. 



microprocessor: A computer 
processor contained in a single 
integrated circuit, such as the 65C02 
microprocessor used in the 
Apple He. 

microsecond: One millionth of a 
second. Abbreviated fiS. 

millisecond: One thousandth of a 
second. Abbreviated ms. 

mode: A state of a computer or 
system that determines its behavior. 
A manner of operating. 

modem: Acronym for 
MOdulator/DEModulator; a 
peripheral device that enables the 
computer to transmit and receive 
information over telephone lines by 
converting digital signals to analog 
signals, and vice-versa. 

modulate: To modify or alter a 
signal so as to transmit information. 
For example, conventional 
broadcast radio transmits sound by 
modulating the amplitude 
(amplitude modulation, ox AM) or 
the frequency (frequency 
modulation, or FM) of a carrier 
signal. 

monitor: See video monitor. 



Monitor program: A system 

program built into the firmware of 
the Apple He, used for directly 
inspecting or changing the contents 
of main memory and for operating 
the computer at the 
machine-language level. 

most significant bit: The 

leftmost bit of a binary number as 
written down. This bit represents 
or 1 times 2 to the power one less 
than the total number of bits in the 
binary number. For example, in the 
binary number 10000, which 
contains five digits, the I represents 
1 times two to the fourth power—or 
sixteen. 

mouse: A small device that you 
roll around on a flat surface next to 
your Apple II family system. A 
small pointer on the screen tracks 
the movement of the mouse. 

nanosecond: One billionth (in 
British usage, one thousand- 
millionth) of a second. Abbreviated 
ns. 

nested loop: A loop contained 
within the body of another loop and 
executed repeatedly during each 
pass through the containing loop. 
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nested subroutine call: A call to 
a subroutine from within the body 
of another subroutine. 

nibble: A unit of information equal 
to half a byte, or four bits. A nibble 
can hold any value from to 15. 
Sometimes spelled nybble. 

NOT: A unary logical operator that 
produces a true result if its operand 
is false, a false result if its operand 
is true. Compare AND, OR, 
exclusive OR 

NTSC: (1) Abbreviation for 
National Television Standards 
Committee. The committee that 
defined the standard format used 
for transmitting broadcast video 
signals in the United States. (2) The 
standard video format defined by 
the NTSC. 

object code: See object 
program. 

object program: The translated 

form of a program produced by a. 
language translator such as a 
compiler or assembler. Also called 
object code. Compare source 
program. 

odd parity: Use of an extra bit set 
to or 1 as necessary to make the 
total number of 1 bits an odd 
number. 



opcode: See operation code. 

operand: A value to which an 
operator is applied. The value on 
which an opcode operates. 

operating system: The most 
fundamental program in a 
computer. It organizes the actions of 
the various parts of the computer 
and allows it to use other programs. 

operation code: The part of a 
machine-language instruction that 
specifies the operation to be 
performed. Often called opcode. 

operator: A symbol or sequence of 
characters, such as + or AND, 
specifying an operation to be 
performed on one or more values 
(the operands) to produce a result. 
See arithmetic operator, 
relational operator, logical 
operator, unary operator, 
binary operator. 

option: An argument that is 
optional. 

OR: A logical operator that 
produces a true result if either or 
both of its operands are true, a false 
result if both of its operands are 
false. Compare exclusive OR, 
AND, NOT 



output: Information transferred 
from a computer to some external 
destination, such as the display 
screen, a disk drive, a printer, or a 
modem. 

output routine: A 

machine-language routine that 
performs the sending of characters. 
The standard output routine writes 
characters to the screen. A different 
output routine might, for example, 
send them to a printer. 

overflow: The condition that 
exists when an attempt is made to 
put more data into a memory area 
than it can hold. 

override: To modify or cancel a 
long-standing instruction with a 
temporary one. 

overrun: A condition that occurs 
when the processor does not 
retrieve a received character from 
the receive data register of the 
ACIA before the subsequent 
character arrives. The ACIA 
automatically sets bit 2 (OVR) of its 
status register; subsequent 
characters are lost. The receive data 
register contains the last valid data 
word received. 
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page: (1) A segment of main 
memory 256 bytes long and 
beginning at an address that is an 
even multiple of 256 bytes, (2) An 
area of main memory containing 
text or graphical information being 
displayed on the screen. (3) A 
screenful of information on a video 
display. With the Apple He, a page 
consists of 24 lines of 40 or 80 
characters each. 

page zero: See zero page, 

parallel interface: An interface 
in which many bits of information 
(typically eight bits, or one byte) are 
transmitted simultaneously over 
different wires or channels. 
Compare serial interface. 

parity: Maintenance of a sameness 
of level or count, usually the count 
of 1 bit in each character, for error 
checking. 

Pascal: A high-level programming 
language with statements that 
resemble English sentences. Pascal 
was designed to teach programming 
as a systematic approach to problem 
solving. Named after the 
philosopher and mathematician, 
Blaise Pascal. 

pass: A single execution of a loop. 



PC board: See printed-circuit 
board. 

peek: To read information directly 
from a location in the computer's 
memory. 

peripheral: At or outside the 
boundaries of the computer itself, 
either physically (as a peripheral 
device) or in a logical sense (as a 
peripheral card). 

peripheral bus: The bus used for 
transmitting information between 
the computer and peripheral 
devices connected to the computer's 
expansion slots. 

peripheral card: A removable 
printed circuit board that plugs into 
one of the expansion slots in the 
Apple He. It expands or modifies the 
computer's capabilities by 
connecting a. peripheral device or 
performing some subsidiary or 
peripheral function. 

peripheral device: An auxiliary 
piece of equipment— such as a 
video monitor, disk drive, printer, or 
modem— used in conjunction with a 
computer and under the computer's 
control. Often (but not necessarily) 



physically separate from the 
computer and connected to it by 
wires, cables, or some other form of 
interface, typically by means of a 
peripheral card. 

peripheral slot: See expansion 
slot. 

phase: (1) A stage in a periodic 
process. A point in a cycle. For 
example, the 65C02 microprocessor 
uses a clock cycle consisting of two 
phases called tf>0 and 0l. (2) The 
relationship between two periodic 
signals or processes. For example, in 
NTSC color video, the color of a 
point on the screen is expressed by 
the instantaneous phase of the 
video signal relative to the color 
reference signal. 

PILOT: Acronym for 
Programmed Inquiry, Learning, 
Or Teaching. A high-level 
programming language designed to 
enable teachers to create 
computer-aided instruction (CAI) 
lessons that include color graphics, 
sound effects, lesson text, and 
answer checking. A version called 
Apple II PILOT is sold by Apple 
Computer for use with the Apple II 
family of computers. 
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pipelining: A feature of a 
processor that enables it to begin 
fetching the next instruction before 
it has finished executing the current 
instruction. All else being equal, 
processors that have this feature 
run faster than those without it. 

plotting vector: A code 
representing a single step in 
drawing a shape on the 
high-resolution graphics screen, 
specifying whether to plot a point at 
the current screen position and in 
what direction to move (up, down, 
left, or right) before processing the 
next vector. 

point of call: The point in a 
program from which a subroutine or 
function is called. 

pointer: An item of information 
consisting of the memory address of 
some other item. For example, 
Applesoft maintains internal 
pointers to (among other things) the 
most recently stored variable, the 
most recently typed program line, 
and the most recently read data 
item. 

poke: To store information directly 
into a location in the computer's 
memory. 



pop: To remove the top entry from 
a stack. 

power supply: A box that draws 
electrical power from a power outlet 
and converts it to the power the 
computer can use to do its 
computing. 

power supply case: The metal 
case inside the Apple lie that houses 
the power supply. 

PR#: The PR# command sends 
output to a slot or a 
machine-language program. It 
specifies an output routine in the 
ROM on a peripheral card or in a 
machine-language routine in RAM 
by changing the address of the 
standard output routine used by the 
computer. 

precedence: The order in which 
operators are applied in evaluating 
an expression. 

printed-circuit board: A 

hardware component of a computer 
or other electronic device, 
consisting of a flat, rectangular 
piece of rigid material, commonly 
fiberglass, to which integrated 
circuits and other electronic 
components are connected. 



procedure: In the Pascal 
programming language, a set of 
instructions that work as a unit; 
equivalent to the subprogram in 
BASIC. 

processor: The hardware 
component of a computer that 
performs the actual computation by 
directly executing instructions 
represented in machine language 
and stored in main memory. 

ProDOS: An Apple II operating 
system designed to support mass 
storage devices like the ProFile as 
well as flexible disk storage devices. 
ProDOS stands tor Professional 
Disk Operating System. 

ProDOS command: Any one of 
the 28 commands recognized by 
ProDOS. Each has its own syntax, 
all can be used within programs, 
and all but five (text file 
commands) can be used from 
immediate mode. 

program: n. A set of instructions 
describing actions for a computer to 
perform in order to accomplish some 
task, conforming to the rules and 
conventions of a particular 
programming language. In 
Applesoft, a sequence of program 
lines, each with a different line 
number, v. To write a program. 
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programmer: The author of a 
program; one who writes programs. 

programming: The activity of 

writing programs. 

programming language: A set of 

rules or conventions for writing 
programs, 

prompt: n. A message on the 

screen, v. To remind or signal the 
user that some action is expected, 
typically by displaying a distinctive 
symbol, a reminder message, or a 
menu of choices on the display 
screen. 

prompt character: A text 
character displayed on the screen to 
prompt the user for some action. 
Often also identifies the program or 
component of the system that is 
doing the prompting; for example, 
the prompt character ] is used by 
the Applesoft BASIC interpreter, > 
by Integer BASIC, and * by the 
system Monitor program. Also called 
prompting character. 

prompt line: A message displayed 
on the screen to prompt the user for 
some action. Also called prompting 
message. 

protocol: A set of rules for sending 
and receiving data on a 
communications line. 



push: To add an entry to the top of 
a stack. 

queue: A list in which entries are 
added at one end and removed at 
the other, causing entries to be 
removed in FIFO (first-in first-out) 
order. Compare stack. 

radio-frequency modulator: A 

device that transforms your 
television set into a computer 
display device. 

RAM: See random-access 
memory. 

random-access memory (RAM): 

Memory in which the contents of 
individual locations can be referred 
to in an arbitrary or random order; 
the readable and writable memory 
of the Apple He. Its contents are 
usually filled with programs from a 
disk, and they are lost when the 
Apple He is turned off. This term is 
often used misleadingly to refer to 
read-write memory, but, strictly 
speaking, both read-only and 
read-write memory can be accessed 
in random order. Random-access 
means that each unit of storage has 
a unique address and a method by 
which each unit can be immediately 
read from or written to. Compare 
read-only memory, read-write 
memory. 



random-access text file: A text 
file that is partitioned into an 
unlimited number of uniform-length 
compartments called records. When 
you open a random-access text file 
for the first time, you must specify 
its record length. No record is placed 
in the file until written to. Each 
record can be individually read from 
or written to— hence, 
random-access. 

raster: The pattern of parallel 
lines making up the image on a 
video display screen. The image is 
produced by controlling the 
brightness of successive dots on the 
individual lines of the raster. 

read: To transfer information into 
the computer's memory from a 
source external to the computer 
(such as a disk drive or modem) or 
into the computer's processor from a 
source external to the processor 
(such as the keyboard or main 
memory), 

read-only memory (ROM): 

Memory whose contents can be read 
but not written; used for storing 
firmware. Information is written 
into read-only memory once, during 
manufacture; it then remains there 
permanently, even when the 
computer's power is turned off, and 
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can never be erased or changed. 
Compare random-access 
memory, read-write memory. 

read-write memory: Memory 
whose contents can be both read 
and written; often misleadingly 
called random-access memory, or 
RAM. The information contained in 
read-write memory is erased when 
the computer's power is turned off, 
and is permanently lost unless it 
has been saved on a more 
permanent storage medium, such as 
a disk. Compare random-access 
memory, read-only memory. 

real number: A number that may 
include a fractional part; 
represented inside the computer in 
floating-point form. Compare 
integer. 

register: A location in a computer 
processor where an item of 
information is held and modified 
under program control. 

relational operator: An operator, 
such as >, that compares numeric 
values to produce a logical result- 
Compare arithmetic operator, 
logical operator. 



reserved word: A word or 
sequence of characters reserved by 
a programming language for some 
special use, and therefore 
unavailable as a variable name in a 
program. 

resident: See memory-resident, 
disk-resident. 

return address: The point in a 
program to which control returns on 
completion of a subroutine or 
function. 

RF modulator: See 
radio-frequency modulator. 

ROM: See read-only memory. 

routine: A part of a program that 
accomplishes some task subordinate 
to the overall task of the program. 

row: A horizontal arrangement of 
character spaces or graphics points 
on the screen. 

RS232 cable: Any cable that is 
wired in accordance with the RS232 
standard, which is the common data 
communications interface standard. 

run: (1) To execute a program. 
(2) To load a program into main 
memory from a peripheral storage 
medium, such as a disk, and 
execute it. 



save: To transfer information from 
main memory to a peripheral 
storage medium for later use. 

scroll: To change the contents of 
all or part of the display screen by 
shifting information out at one end 
(most often the top) to make room 
for new information appearing at 
the other end (most often the 
bottom), producing an effect like 
that of moving a scroll of paper past 
a fixed viewing window. See 
window. 

serial interface: An interface in 
which information is transmitted 
sequentially, one bit at a time, over 
a single wire or channel. Compare 
parallel interface. 

setup time: The amount of time a 
signal must be valid in advance of 
some event. Compare hold time. 

silicon: A non-metallic, 
semiconducting chemical element 
from which integrated circuits are 
made. Not to be confused with 
silica— that is, silicon dioxide, such 
as quartz, opal, or sand— or with 
silicone, any of a group of organic 
compounds containing silicon. 
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simple variable; A variable that is 
not an element of an array. 

simplified keyboard: The 

Dvorak keyboard. 

6502: The type of microprocessor 
used in the Apple II, II Plus, and 
original He. 

65C02: The type of microprocessor 
used in the enchanced Apple He and 
the Apple He. 

slot: A narrow socket inside the 
computer where you can install 
peripheral device cards. 

soft switch: A means of changing 
some feature of the computer from 
within a program; specifically, a 
location in memory that produces 
some special effect whenever its 
contents are read or written. 

software: Instructions that tell the 
computer what to do. They're 
usually stored on disks. Compare 
hardware, firmware. 

source program: The original 
form of a program given to a 
language translator such as a 
compiler or assembler for 
conversion into another form; 
sometimes called source code. 
Compare object program. 



space character: A text character 
whose printed representation is a 
blank space, typed by pressing the 
I space | bar. 

stack: A list in which entries are 
added or removed at one end only 
(the top of the stack), causing them 
to be removed in LIFO (last-in 
first-out) order. Compare queue, 

standard instruction: An 

instruction automatically present 
when no superseding instruction 
has been received. 

startup: To get the system 
running. For example, In the 
context of ProDOS, starting up is the 
process of reading the ProDOS 
program (in the files PRODOS and 
BASIC.SYSTEM) from the disk, and 
running it. 

starting value: The value 
assigned to the index variable on 
the first pass through a loop. 

startup disk: A disk containing an 
operating system and a self-starting 
program. 

statement: A unit of a program in 
a high-level language that specifies 
an action for the computer to 
perform, typically corresponding to 
several instructions of machine 
language. 



step value: The amount by which 
the index variable changes on each 
pass through a loop, 

string: An item of information 

consisting of a sequence of text 
characters. 

strobe: A signal whose change is 
used to trigger some action. 

subroutine: A part of a program 
that can be executed on request 
from any point in the program, and 
which returns control to the point of 
the request on completion. 

synchronous transmission: A 

transmission process that requires 
an integral number of unit (time) 
intervals between any two 
significant instances. In 
synchronous communications, the 
transmitter and receiver are in step 
with each other, and characters 
being transmitted follow one after 
the other at regular intervals. 
Compare asynchronous 
transmission. 

syntax: The rules governing the 
structure of statements or 
instructions in a programming 
language; a representation of a 
command that specifies all the 
possible forms the command can 
take. 
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system: A coordinated collection of 
interrelated and interacting parts 
organized to perform some function 
or achieve some purpose. 

system configuration: See 
configuration. 

system program: A program that 
makes the resources and 
capabilities of the computer 
available for general purposes, such 
as an operating system or a 
language translator. Compare 
application program. 

system software: The component 
of a computer system consisting of 
system programs, 

TAB: An ASCII character that 
commands a device such as a 
printer to start printing at a preset 
location (called a tab stop). There 
are two such characters;: horizontal 
tab (hex $09) and vertical tab (hex 
$0B). 

television set: A display device 
capable of receiving broadcast video 
signals (such as commercial 
television) by means of an antenna. 
Can be used in combination with a 
radio-frequency modulator as a 
display device for the Apple He. 
Compare video monitor. 



terminal: A device consisting of a 
typewriter-like keyboard and a 
display device, used for 
communicating between a computer 
system and a human user. Personal 
computers such as those in the 
Apple II family of computers 
typically have all or part of a 
terminal built into them. 

text: (1) Information presented in 
the form of characters readable by 
humans. (2) The display of 
characters on a display screen. 
Compare graphics. 

text window: An area on the video 
display screen within which text is 
displayed and scrolled. 

traces: Electrical roads that 
connect the components on a circuit 
board. 

transistor-transistor logic 
(TTL): (1) A type of integrated 
circuit used in computers and 
related devices. (2) A standard for 
interconnecting such circuits that 
defines the voltages used to 
represent logical zeros and ones. 

troubleshoot: To locate and 
correct the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
hardware-related problems. 
Compare debug. 



TTL: See transistor-transistor 
logic. 

turnkey disk: A disk that 
executes a specific application 
program when you use that disk to 
start, the computer, 

turnkey program: A program, 
such as a game or application, that 
runs automatically when the disk 
that the program is on is used to 
start up the computer. 

unary operator: An operator that 
applies to a single operand; for 
example, the minus sign (-) in a 
negative number such as -6 is a 
unary arithmetic operator. Compare 
binary operator. 

unconditional branch: A branch 
that does not depend on the truth of 
any condition. Compare 
conditional branch. 

value: An item of information that 
can be stored in a variable, such as a 
number or a string. 

variable: (1) A location in the 
computer's memory where a value 
can be stored. (2) The symbol used 
in a program to represent such a 
location. Compare constant, 
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vector: (1) The starting address of 
a program segment, when used as a 
common point for transferring 
control from other programs, (2) A 
memory location used to hold a 
vector, or the address of such a 
location. 

video: (1) A medium for 
transmitting information in the form 
of images to be displayed on the 
screen of a cathode-ray tube. (2) 
Information organized or 
transmitted in video form. 

video monitor: A display device 
capable of receiving video signals by 
direct connection only, and which 
cannot receive broadcast signals 
such as commercial television. Can 
be connected directly to the 
computer as a display device. 
Compare television receiver. 

volume: A general term referring 
to a storage device; a source or 
destination of information, A 
volume has a name and a volume 
directory with the same name. Its 
information is organized into files. 

window: The portion of a 
collection of information (such as a 
document, picture, or worksheet) 
that is visible on the display screen. 



word: A group of bits of a. fixed size 
that is treated as a unit; the number 
of bits in a word is a characteristic 
of each particular computer, 

write: To transfer information 
from the computer to a destination 
externa] to the computer (such as a 
disk drive, printer, or modem) or 
from the computer's processor to a 
destination external to the processor 
(such as main memory). 

write-enable notch: The square 
cutout on one edge of a disk's jacket 
that permits information to be 
written on the disk. If there is no 
w r rite-enable notch, or if it is covered 
with a write-protect tab, 
information can be read from the 
disk but not written onto it. 

write-protect: To protect the 
information on a disk by covering 
the write-enable notch with a 
write-protect tab, preventing any 
new information from being written 
onto the disk. Compare copy 
protect. 

write-protect tab: A small 
adhesive sticker used to 
write-protect a disk by covering the 
write-enable notch. 



X register: One of the index 
registers in the 65C02 
microprocessor. 

Y register: One of the index 
registers in the 65C02 
microprocessor. 

zero page: The first page (256 
bytes) of memory in the Apple lie, 
also called page zero. Since the 
high-order byte of any address in 
this page is zero, only the low-order 
byte is needed to specify a zero- page 
address; this makes zero- page 
locations more efficient to address, 
in both time and space, than 
locations in any other page of 
memory. 
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